# shofa Field Manual (/docs)

shofa is a production-ready TypeScript monorepo template for teams that would rather ship product than rebuild auth, deployment, database, job, admin, and docs plumbing from scratch.

## What this manual is for [#what-this-manual-is-for]

Use these docs to inspect the seams before adopting the template. The goal is not to hide complexity. The goal is to put the decisions, tradeoffs, and production fixes where senior developers can audit them fast.

<Cards>
  <Card title="Template reference" href="/docs/test" description="Understand the replaceable project values, package boundaries, and starting points." />
  <Card title="Changelog" href="/docs/changelog" description="Track what changed in the template and why the defaults evolved." />
</Cards>

## Operating assumptions [#operating-assumptions]

| Area | Default |
| ---- | ------- |
| API | Hono on Cloudflare Workers with typed boundaries |
| App | TanStack Start with route-level data loading |
| Auth | Better Auth with split-domain deployment concerns documented |
| Data | D1 and Drizzle with edge constraints called out |
| Jobs | Trigger.dev packaged for background product flows |

## First adoption pass [#first-adoption-pass]

```sh
pnpm run init-project
pnpm install
pnpm dev
```

After the initializer runs, read the production fixes and package boundaries before adding product code. That is where the template saves the most senior engineering time.