Starters

Project Starters

Scaffold a complete, opinionated backend in one command. Each starter overlays the relevant official packages and a wired-up feature module on top of the base app — pick one and start building.

Use the --starter flag (alias of --template) with street create:

1

npx @streetjs/cli create my-app --starter saas

Combine with --frontend next|react|htmx and --database postgres|sqlite as needed.

Available starters

Starter Command What you get
SaaS --starter saas Multi-tenant orgs & teams, RBAC (core requireRoles), invitations, API keys, audit logs, notifications, and billing placeholders — all on the base app, no extra runtime deps by default
AI --starter ai Provider-agnostic chat, embeddings and RAG scaffolding (@streetjs/ai)
Realtime --starter realtime WebSocket channels, presence and typing
Marketplace --starter marketplace Products, inventory, carts, orders, payments (@streetjs/commerce)
Dating --starter dating Encrypted profiles, likes, reciprocal matching (@streetjs/dating-profiles)
Minimal (no flag) HTTP, DI, database and health checks — the base app

Friendly aliases resolve automatically: realtime → realtime-chat, marketplace → ecommerce, dating → dating-app.

SaaS opt-in modules (--with-*)

The SaaS starter keeps the default scaffold dependency-minimal: orgs, RBAC, multi-tenancy, audit and notifications are built on the core framework with no third-party runtime dependencies. Richer integrations are opt-in flags that add their package only when requested:

Flag Adds Package(s)
--with-billing Signature-verified Stripe webhook controller + billing module @streetjs/plugin-stripe
--with-marzpay MarzPay billing, subscription, checkout/webhook modules + dashboard @streetjs/plugin-marzpay
--with-admin-ui Server-rendered auth + RBAC management screens @streetjs/auth-ui, @streetjs/admin-ui
--with-email Email delivery for notifications (injected Mailer) @streetjs/plugin-sendgrid 
1
2

# SaaS with Stripe billing and the auth/RBAC management screens:
npx @streetjs/cli create my-saas --starter saas --with-billing --with-admin-ui

The managed @streetjs/admin AdminService (wildcard permissions, can(), audit primitives) is an optional enhancement you install separately — the base SaaS starter does not depend on it.

SaaS starter architecture

What --starter saas scaffolds (every module is overlay code you own — not framework code). Org-scoped modules go through orgScopedRepo (tenant.ts) so every query/mutation is constrained to the caller’s org_id:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

HTTP request
   │
   ▼
StreetJS HTTP server
   ├─ authMiddleware (JWT)            core
   ├─ requireRoles(...) (RBAC)        core   ← owner/admin/member
   ├─ apiKeyAuth (X-API-Key)          src/middleware/apiKeyAuth.ts
   └─ tenant scoping                  src/middleware/tenant.ts → orgScopedRepo(org_id)
        │
        ▼  modules (controller → service → org-scoped repository)
   ┌───────────────┬──────────────────┬───────────────────────┐
   │ orgs          │ members           │ invitations           │
   │ apikeys       │ settings          │ audit                 │
   │ notifications │ dashboard (SSR)   │ billing               │
   └───────────────┴──────────────────┴───────────────────────┘
        │
        ▼
   PostgreSQL  (organizations, memberships, invitations, api_keys,
                audit_logs, notifications, subscriptions)

Opt-in overlays (added only with the matching --with-* flag):
   --with-billing   → billing.controller.ts        (@streetjs/plugin-stripe)
   --with-marzpay   → marzpay-{billing,subscription}.service.ts,
                      marzpay-{checkout,webhook}.controller.ts,
                      dashboard/billing-dashboard.controller.ts  (@streetjs/plugin-marzpay)
   --with-admin-ui  → dashboard/auth-ui.controller.ts   (@streetjs/auth-ui, @streetjs/admin-ui)
   --with-email     → notification email transport       (@streetjs/plugin-sendgrid)

Tenant isolation and API-key scoping are covered by property-based tests in the CLI package (saas-tenant-isolation.pbt.test.ts, saas-apikey-scoping.pbt.test.ts).

Next steps after scaffolding 

1
2
3

cd my-app
npm install
street dev

Starters compose existing official packages and generators — no lock-in, no generated code you can’t read or change.