[ProjectAJ14]

What changes?

Projects generated by nonstop create now start with a Claude Code "system boundary": clear rules for how to set up, run, change and troubleshoot the repo.

Claude Code setup in every generated mono-repo

• A root CLAUDE.md, titled with the project name and followed by its description, the same way the README starts. It covers setup, run, commands, strict SOLID and Flutter rules, definition of done, troubleshooting, and how to communicate with the user.
• One CLAUDE.md per area (apps/, features/, packages/, plugins/) and per member (app, auth, dashboard, 11 packages). Each covers public API, layout, rules, common changes, tests and gotchas.
• Docs are gated per selected module. A project without auth, say, never mentions features/auth.
• .claude/settings.json:
  • an allowlist of the usual melos/flutter commands;
  • reads of .env and keystores are denied;
  • a hook blocks hand edits to generated files (*.g.dart, *.i69n.dart, generated theme, pubspec.lock);
  • a hook runs dart format on every Dart file Claude edits.
• Skills: melos-workspace, new-feature, flutter-best-practices, design-system, troubleshooting.
• The package, app and plugin bricks add a starter CLAUDE.md for new members.

CLI

• nonstop create --template package|app|plugin inside a mono-repo now adds the member to the root workspace: list and sets resolution: workspace. Before, dart pub get rejected new members until they were edited by hand.

Template fixes found while documenting it

• Dashboard no longer imports auth: the app passes in the route guard and sign-out.
• Sign-out: also unregisters the device push token when notifications are enabled. A backend failure is logged and doesn't block sign-out.
• Startup: an offline Remote Config fetch no longer fails it.
• Privacy: no user IDs, emails or names in logs or crash reports; the email domain is no longer sent to analytics.
• Analytics: sign-up logged a sign-in event, and one redirect event fired twice; both fixed.
• Rule compliance:
  • strings come from localization and colors from the theme;
  • dependencies are injected through constructors, with no di.get in build;
  • contracts are abstract interface class;
  • unused dependencies are removed.
• Docs: READMEs rewritten from the code (network, analytics, crashlytics, feature_flags; notifications is new). Health-specific helpers left over from an earlier product are removed.
• Small bugs: wrong nonstop create syntax in the area READMEs; an unused material import when dashboard is on and auth is off.

Example snapshot

• packages/nonstop_cli/example/nonstop_example is the committed output of nonstop create with every module on. Regenerate it with melos run generate:nonstop_example; never edit it by hand.
• It's excluded from the repo-wide lint and from the published package (.pubignore).

Validation

• dart test in packages/nonstop_cli: 87 passed, including all 512 module combinations and the new workspace tests.
• dart run tool/verify_template.dart <profile> for full, default, minimal, auth-only, network-only and firestore-only: lint clean, 100% line coverage and flutter build web for each.
• Extra combinations --no-auth and --no-notifications: lint clean, 100% coverage.
• Doc checker over every generated doc in all 512 combinations: no mentions of disabled modules, no leftover template tags, no broken tables.
• Regenerated example: lint clean, coverage 2309/2309 (100%), web build OK. Its docs match the reviewed hand-written versions except for the project-name titles and the bash prefix on the hook commands.
• nonstop create demo_pkg --template package inside the example: the package was added to the workspace, dart pub get resolved, and it got a starter CLAUDE.md.
• Repo-wide melos lint: no issues.
• Not done: device runs (iOS/Android), and running against a real Firebase project.

Compatibility

Affected package: nonstop_cli (bricks and create command). Only newly generated projects change; existing projects are untouched. If you copied older generated code, note these API changes:

• AssetImage → AppAssetImage
• crashlytics enableAutomaticDataCollection → installGlobalErrorHandlers
• UserMetadata now has only userId
• DependencyInjection.init() removed
• FeatureFlag is now an interface (its constructor still works)

Checklist

• The PR title follows Conventional Commits.
• Relevant analysis and tests pass; behavior changes have appropriate tests.
• Documentation/examples are updated where needed.
• Package versions and changelogs are left to Melos.
• New public packages include a README, LICENSE, tests and release setup from docs/RELEASING.md (no new public packages).
• No credentials, private data or generated build output are included.

🤖 Generated with Claude Code