# __APP_TITLE__

## Intent

Desktop + mobile friendly Kody package app scaffolded from `@kentcdodds/package-app-kit` `starter-tanstack/`.
Replace this Intent with the product goal before the first real publish.

## Stack

- **TanStack Router + React** under the framework-agnostic host — `app/router.ts` remounts + `export default { fetch }` (no `kody.app.runtime`)
- Root `tsconfig.json` with `"jsx": "react-jsx"` + `"jsxImportSource": "react"` (standard React — not remix/component)
- `@tanstack/react-router` route tree (`app/routeTree.tsx`) with Workers SSR via `react-dom/server.edge` `renderToReadableStream` (**no** TanStack Start / Vite)
- Mount-prefixed routes (`basepath` + remount) and `createRoutes(appBasePath)` href helpers
- Controllers + notes POST with `packageStorage()`; JSON `Accept` for client loaders
- Browser `hydrateRoot` entry (`app/assets/entry.ts`) + `RouterProvider`
- Static assets (`public/styles.css`, `public/sw.js` via `__version.json`)
- Kit: design tokens CSS, record-version / About, install CTA + update banner, Notes form + double-check

## List mark

Identity/list icon: `.kody/icon.png` (scaffold ships `.kody/icon.svg`). Replace with your logo. PWA icons stay under `/icons/` via the kit — not in `.kody/`.

## After scaffolding

See **After scaffolding** in [`AGENTS.md`](./AGENTS.md): brand the list mark + PWA icons, fill titles/description, keep local `record-version`, confirm the TanStack recipe, and match manifest theme colors to the mark.

## Develop locally

You need Node 24+ and git.

```bash
git clone https://kody.codes/__PACKAGE_NAME__.git
cd __PACKAGE_ID__
npm install
npm run setup   # first time only: kody login + git access
npm run dev     # local app with mock data and fake credentials
```

Common scripts:

- `npm run dev`: run the app locally on mock data (`npm run dev:prod` uses your real data)
- `npm run fetch -- /health`: request one path without opening a browser
- `npm run job -- <name>`, `npm run webhook -- <name> --body fixtures/webhook.example.json`, `npm run emit -- <event> --body fixtures/event.example.json`: trigger jobs, webhooks, and events once
- `npm run check`, `npm run typecheck`, `npm test`: catch problems before you ship
- `npm run publish:kody`: run tests and the pre-publish check, then publish what you pushed

Ship changes with `git push`, then `npm run publish:kody`. No terminal? Ask your Kody agent to make and publish changes instead; [`AGENTS.md`](./AGENTS.md) has the full workflow.


## After publish

Call **this package's** `./record-version` (local `packageStorage`), not the kit's:

```ts
import recordVersion from 'kody:__PACKAGE_NAME__/record-version'
await recordVersion({ sha: '<published_commit>', message: '<commit message>' })
```