Et Cloudflare-først B2B SaaS-startpunkt
Arbeidsområder, autentisering, REST + MCP, webhooks, e-post, revisjon og administrasjon, typet ende til ende og bevist av en fungerende referanseapp. Den starter lokalt uten leverandørhemmeligheter.
vp installpnpm run db:migrate:localpnpm run db:seedpnpm run devDet samme oppslaget som fylte tallene over, fulgt fra curl-kallet som starter det til bindingen som lagrer det. Alle utdragene nedenfor er ekte kode fra dette repoet; bildeteksten på hvert panel viser stien. I sidestolpen lyser noden som omtales mens du leser.
HTTP client
En vanlig GET med bearer-autentisering. Kroppen som vises nedenfor er den aktive oversikten siden brukte til å vise tallene, ikke en fixture: det første varselet vises i sin helhet, og resten telles uten omskriving.
curl -H "Authorization: Bearer bsk_live_xxx" \
https://api.example.com/workspaces/starter-lab/overview
{
"workspace": {
"id": "wrk_starter",
"slug": "starter-lab",
"name": "Starter Lab",
"planId": "team"
},
"notifications": []
}apps/api
Ruten finnes fordi kontrakten sier at den skal finnes. Sti, parametere, suksesskjema og den typede feilkanalen ligger i én deklarasjon: WORKSPACE_ERRORS er WorkspaceNotFound, Unauthorized, AuthorizationDenied, RateLimited og CapabilityUnavailable — kodet på endepunktet, ikke kastet som tekst. Bearer-sperren følger gruppen, så et søsterendepunkt kan ikke lanseres uten den.
export const WorkspaceApi = HttpApiGroup.make('workspace')
.add(
HttpApiEndpoint.get('overview', '/workspaces/:slug/overview', {
params: SlugParams,
success: WorkspaceOverviewDto,
error: WORKSPACE_ERRORS
})
)
.middleware(BearerAuth)packages/capabilities
Begge overflater kaller samme effekt. Feilkanalen og tjenestekravene er en del av typen, slik at alle kallere deler ett feilvokabular og kompilatoren kontrollerer koblingen — en påstand på denne siden som ikke kan forfalskes.
export const workspaceOverview: Effect.Effect<
WorkspaceOverviewProjection,
CapabilityUnavailable,
WorkspaceContext | NotificationFeed
> = Effect.gen(function* () {
const ctx = yield* WorkspaceContext
const feed = yield* NotificationFeed
const notifications = yield* feed.list
return {
workspace: ctx.workspace,
notifications
}
})return runWorkspaceCapabilities(
DEMO_WORKSPACE_SLUG,
Effect.all({ overview: workspaceOverview, memberCount: … })
).handle('overview', ({ params, request }) =>
workspaceRead(READ_OPERATIONS.overview, params, undefined, request)
)const invoke = yield* decodeOperationInput(operation, payload)
yield* requirePermission(yield* callerPrincipal(caller), operation.permission)
return yield* invokeD1 · Queues · Email
Hver binding under effekten deklareres én gang i alchemy.run.ts: den samme TypeScript-beskrivelsen setter opp lokal utvikling og produksjon, så historien ender med deploy-kommandoen. pnpm run deploy.
| binding | hva den inneholder | deklarert i |
|---|---|---|
| D1 | SQLite: skjema, migreringer og seed-rader | packages/db |
| Queues | Webhook-leveranser med nye forsøk og tilbakekobling | apps/background |
| Transaksjonelle utsendinger, leverandørstyrt til den er konfigurert | packages/email |
Disse integrasjonene er valgfrie og forblir inaktive til de konfigureres.
Stripe
Stripe
Miljøstyrt
Sentry
Sentry
Miljøstyrt
PostHog
PostHog
Miljøstyrt
Cloudflare Email
E-post
Miljøstyrt
Turnstile
Turnstile
Miljøstyrt
Dokumentasjon, FAQ og blogg er versjonert MDX i repoet og søkes fra genererte indekser, uten CMS. Bloggen forklarer hvorfor hver teknologibeslutning ble tatt, og utgivelser lages av release-please.
docs/
Svar om fakturering, lisensiering og hvordan du tar B2B SaaS Starter i bruk i produktet ditt.
MIT-lisensiert. Referanseappen kjører lokalt mot et eksempelarbeidsområde: ingen Stripe-nøkkel, OAuth-app eller e-postdomene er nødvendig.
kloning og hurtigstart