# %%PROJECT_NAME%%

A Yujin Forge **Next.js (App Router)** starter, NAC-3 conformant by construction.

## Stack

- **Next.js 15** with the App Router (`src/app/`).
- **React 18** + TypeScript 5.
- **@yujin/nac 2.3.x** -- NAC-3 runtime + manifest types.
- **Vitest** for unit tests, **Playwright** for e2e.

## Why Next.js (vs the react-app starter)

Pick this starter when you need:
- Server-side rendering / streaming for SEO or fast first paint.
- Route-level code splitting + edge runtime.
- Built-in API routes (no separate backend yet).
- File-based routing (App Router conventions).

If you just want a SPA, the `react-app` template is leaner (Vite,
no server runtime, fastest dev).

## Quick start

```bash
npm install
npm run dev          # http://localhost:3000
```

## Tests

```bash
npm run test            # Vitest unit tests
npm run test:e2e        # Playwright e2e (requires `npx playwright install` once)
npm run typecheck       # TypeScript strict mode
npm run lint            # next lint (eslint-config-next)
```

## Yujin Forge integration

Open the project in `yf chat` to drive development via voice + chat:

```bash
yf chat
```

The chat panel reads `src/nac/manifest.ts` and exposes each
manifest element as a tool the AI can invoke.
