Files

T

imbytecat 7e27640a26 feat(deploy): migrations 嵌入二进制，实现真单文件部署

- embed-migrations.ts：扫 ./drizzle/meta/_journal.json，生成 src/server/db/migrations.gen.ts，每条 SQL 通过 `import sql_<idx> from '../../../drizzle/<tag>.sql' with { type: 'text' }` 在 bun build --compile 时被静态嵌入二进制
- migrate.ts 重写：runtime 用 createHash('sha256') 计算迁移哈希，仅用 db.execute(sql) + db.transaction() 公开 API 写入 drizzle.__drizzle_migrations 簿记表（不依赖 @internal 的 db.dialect/db.session）
- db:generate 链 db:embed，保证 SQL 改动总是同步到 migrations.gen.ts
- Dockerfile 删 COPY drizzle/，binary 是部署唯一 artifact
- 同步 README / AGENTS / biome.json

2026-04-25 14:05:58 +08:00

2.9 KiB

Raw Blame History

fullstack-starter

Opinionated single-binary fullstack starter. Bun + TanStack Start (React 19 SSR) + ORPC (contract-first) + Drizzle + PostgreSQL, deployed as one compiled executable.

Agent notes and non-obvious invariants live in AGENTS.md. Read it before making structural changes.

Quick start

cp .env.example .env
bun install
bun run db:push     # dev: sync schema without migration files
bun run dev         # http://localhost:3000

RPC endpoint: /api/rpc · OpenAPI docs: /api/docs · Spec: /api/spec.json · Liveness: /health.

Scripts

Command	What it does
`bun run dev`	Vite dev server on port 3000 (strict)
`bun run build`	Build to `.output/`
`bun run compile`	Single-binary `out/server-<target>` via `bun build --compile`
`bun run cli <cmd>`	Run a CLI subcommand in source (`serve`, `migrate`)
`bun run typecheck`	`tsc --noEmit`
`bun run test`	`bun test` (colocated `*.test.ts`)
`bun run fix`	Biome lint + format + organize imports
`bun run db:push`	Dev-only schema sync (no migration files)
`bun run db:generate`	Write SQL migrations to `./drizzle` and regenerate `migrations.gen.ts`
`bun run db:embed`	Regenerate `src/server/db/migrations.gen.ts` from `./drizzle` (run if you hand-edit migrations)
`bun run db:migrate`	Apply migrations locally via drizzle-kit (dev convenience)
`bun run db:studio`	Drizzle Studio

Cross-compile: bun run compile:{linux,darwin,windows}[:arch].

Add a feature (e.g. `post`)

Contract-first, additive. Create or touch files in this order:

src/server/db/schema/post.ts — define postTable, spread ...generatedFields.
src/server/db/schema/index.ts — export * from './post'.
src/server/api/contracts/post.contract.ts — derive Zod from the table via drizzle-zod.
src/server/api/contracts/index.ts — add post to the contract object.
src/server/api/routers/post.router.ts — implement os.post.*.handler(...).
src/server/api/routers/index.ts — add post to the router object.
src/client/queries/post.ts — export useInvalidatePosts (or finer-grained helpers) for affected list keys.
src/routes/<page>.tsx — UI with useSuspenseQuery + loader ensureQueryData; call the helper from mutation onSuccess.
bun run db:generate — emit SQL migrations to ./drizzle and embed them into src/server/db/migrations.gen.ts.

Deploy

Always migrate-then-serve. Migrations are embedded in the binary; the binary is the only artifact you ship.

./server migrate   # applies embedded migrations against $DATABASE_URL
./server           # starts HTTP server (default subcommand)

compose.yaml models the pattern with a one-shot migrate service that app depends on (service_completed_successfully). On Kubernetes: run ./server migrate as an initContainer or Helm pre-upgrade Job.

docker compose up --build

2.9 KiB Raw Blame History