Skip to content
stackchainstackchain

Best practices

Config

Section titled “Config”
  1. Prefer a preset, then override only what you must.
  2. Keep feature names snake_case (auth, user_profile).
  3. Commit stackchain.yaml and .stackchain/lock.yaml.

Day to day

Section titled “Day to day”
  1. Add features with feature — don’t hand-wire routes/DI.
  2. Put custom methods in // <stackchain:custom> — not inside generated / routes markers.
  3. Put custom assertions in test/features/<feature>_custom_test.dart.
  4. Use test <feature> for the full suite; refresh with --overwrite when needed.
  5. Preview big changes: --dry-run before migrate or --overwrite.

Evolving

Section titled “Evolving”
Need Command
Re-wire routes/DI sync
Refresh packages upgrade
Switch Bloc → Cubit, etc. migrate --state cubit
Full test suite test auth or test --all

Security

Section titled “Security”

Keep secure_storage for tokens. Turn on strict_quality: true for production apps.