Appearance

Common Gotchas ​

Most early friction comes from treating raclette apps like traditional app boilerplates.

Common Mistakes ​

  • Using yarn add instead of yarn add-package for runtime dependencies.
  • Editing generated files in .raclette/ (changes are overwritten).
  • Treating raclette apps like classic app-boilerplates (adding own framework entrypoints).
  • Using service overrides as a default workflow instead of plugin development.
  • Forgetting plugin metadata (raclette.plugin.ts) and required backend entry (backend/index.ts).

Safer Defaults ​

  • Build features in plugins first.
  • Treat .raclette as generated output.
  • Use add-package for runtime dependencies.