Skip to content

Engineer onboarding

Read the ADRs first, then the Keferboeck platform KB (docs.keferboeck.com) for the droplet, email and release fundamentals.

  • Repo: keferboeck/solidus-demos, local ~/Development/RoR/georgkeferboeck/solidus-demos. Five standalone apps in subdirectories; work inside one shop at a time.
  • Local dev: per shop bin/setup then PORT=<port> bin/dev; hampers runs permanently as a launchd agent on 3020 (never start it manually). Postgres credentials come from ~/.pgpass. Outgoing dev mail is written to tmp/mails, never sent.
  • Demo data: bin/rails demo:reset_catalogue rebuilds the catalogue; bin/rails demo:image_brief regenerates the imagery brief for the FLUX pipeline.
  • Conventions: bilingual EN/DE locales for every visible string; per-currency price lists, never conversion; money in integer pence; showcase mode annotations for prospect-facing features; ClickUp tasks with the mandatory structure; copy rules (no dashes, British English, du-form German).
  • Secrets: per-shop .kamal/ git-ignored files (Stripe keys in config/stripe.yml, hub store key in .kamal/hub_store_key). Never commit, never paste.