Skip to content

Releases: eouzoe/good-techstack

v0.0.1-beta — Initial release

Pre-release

Choose a tag to compare

@eouzoe eouzoe released this 24 Jul 01:15

v0.0.1-beta — Initial release

First tagged release of good-techstack. A working, deployable full-stack template for Cloudflare Workers.

Features

  • Runtime: Bun workspace monorepo with Web Standards API
  • API: Hono + oRPC — contract-first RPC with full type safety
  • Database: Drizzle ORM over D1 (Cloudflare SQLite)
  • Auth: better-auth — email, OAuth, SSO, session management
  • Frontend: TanStack Start with Rsbuild — React, SSR, RSC
  • UI: shadcn/ui — Tailwind CSS 4 components
  • Toolchain: oxlint + oxfmt — Rust-based linting and formatting
  • Infrastructure: Cloudflare Workers — D1, R2, KV, Queues, DO
  • Environment: Nix + devenv 2.x — reproducible shells

AI Integration

  • just agent — one-command AI agent launch (Claude Code / Codex / opencode)
  • Prompt section in README — drop-in instructions for any AI coding agent
  • Agent-documented stack — docs/en/agent/ written for AI consumption
  • Scaffold protocol — 7-question Q&A → entity map → code generation

Documentation

  • British English technical reference — 8-layer deep dive (runtime, API, DB, auth, frontend, schema, infra, testing)
  • Traditional Chinese translation — 13 docs covering all layers
  • Getting-started guide, development, deployment, testing guides
  • Design decisions — why each tool was chosen and what to avoid
  • MCP reference — Cloudflare MCP server selection and configuration

Developer Experience

  • just dev — starts backend + frontend with one command
  • just init — auto-generates bindings, typechecks, seeds dev secrets
  • just lint / just typecheck / just test — fast feedback loops
  • Modular Justfile — just-modules/ for user extensibility
  • SecretSpec — replaces .env with auditable secret management

CI

  • Three-OS typecheck pipeline (Linux, macOS, Windows)
  • Nix + devenv for reproducible environments
  • Pre-commit hooks (oxlint → oxfmt)

Notes

  • Beta software. Core flow works (bootstrap → dev → deploy) but edge cases remain.
  • Security audit and formal test matrix are planned but not yet implemented.
  • See docs/en/guide/contribution-areas.md for known gaps.