Skip to content
Lever elke weekShipping systemdeveloper-experience

Vangrails voor releasen

Generators en checks houden nieuwe features op het veilige pad. Half werk komt niet live.

Generators en checks houden nieuwe features op het veilige pad. Half werk komt niet live.

  • 1 command to start a full feature
  • 0 unfinished features that can reach production
  • 1 paved check to run before you ship

Hoe het werkt

Het mechanisme van begin tot eind, zoals het in de repository is geïmplementeerd.

  1. 1

    Scaffold the slice

    One command generates the whole feature: input contracts, permission-checked server services, client wiring, a tenant-scoped live-sync shape, and its tests. It refuses to overwrite existing code.

  2. 2

    Build with fast feedback

    Test commands run only what your changes touch, and a doctor command reports config and service health without printing secrets.

  3. 3

    Certify to promote

    A certification run is the only way a draft feature becomes production-ready. CI rejects anything that skipped it.

  4. 4

    Verify before release

    One verify pass runs the architecture, registry, migration, and bundle-size gates, so drift shows up as a failed check with evidence, not a surprise in production.

Interactief voorbeeld

Bekijk het in werking

Deze rondleiding toont het geïmplementeerde backendcontract zonder account, credentials of providercalls.

Interactief voorbeeld

Walk the paved development path

  1. $ bun run scaffold resource · geslaagd

Toont 1 van 4 controles

Alleen deterministische voorbeelddata. De interactie gebruikt geen account-, provider- of netwerkverbinding.

Het probleem dat dit oplost

Zonder een gedeelde basis bouwt elk team deze randgevallen opnieuw — en anders.

The copy-paste that lost the lock

New features start by copying the last one. Each copy drops a permission check here, a version column there, until the pattern isn't a pattern anymore. Here, features are generated complete, every time.

The prototype that went live

A half-finished experiment gets registered, deployed, and depended on before anyone decided it was ready. Here, draft code is locked out of production until it passes certification.

Rules that live only in a wiki

Your conventions sit in a markdown file nobody reads under deadline. They get re-argued in every review and quietly broken between reviews. Here, breaking them fails a check.

Kernpunten

Waarom dit belangrijk is

Whole features, not snippets

One command generates the full slice: input checks, permission-checked server code, client wiring, live sync, and tests, already connected.

Unfinished stays unshipped

New scaffolds are marked immature and locked out of production until a certification run proves they work.

Shortcuts turn red

A pattern check catches known footguns, like unscoped caches or server secrets imported in the browser, and fails the build instead of letting them spread.

Technische garanties

Wat dit wel en niet belooft

Veiligheidsgrens

Achter de schermen houden autorisatie, tenantgrenzen en foutafhandeling één duidelijke eigenaar. Zo blijft de snelle ervaring voor gebruikers gekoppeld aan veilig herstel als het misgaat.

Implementatiebewijs

De grens hierboven is geen claim maar code. Deze bestanden dragen het contract:

  • scripts/scaffold.ts
  • scripts/certify-resource.ts
  • scripts/check-patterns.ts
  • docs/DEVELOPER-EXPERIENCE.md
  • docs/RELEASE-CERTIFICATION.md
Vragen

Veelgestelde vragen

Bouw verder op Vangrails voor releasen

De documentatie beschrijft dezelfde contracten die deze pagina demonstreert.