# Use and adapt w-ai

Use the documented interfaces and source layout for **w-ai**. The sections below retain the README’s examples and configuration details.

## Stack

- Next.js (App Router) + TypeScript
- Convex (DB + functions)
- better-auth
- Puck page builder
- shadcn/ui + Tailwind + next-intl (ar/en)

## App surfaces

- Marketing landing (`/`) — product site for Curious Vessel
- Dashboard (`/dashboard`) — sites list, sidebar, pages, domains, site config
- Tenant sites (`{slug}.*` / custom domain) — published Puck pages

## Dev

```bash
pnpm install
cp .env.example .env.local
pnpm dev
```

## Commands in the root manifest

The captured [package.json](https://github.com/Up-to-code/w-ai/blob/HEAD/package.json) declares the following scripts. Run them from the directory containing that manifest.

| Command | Script |
| --- | --- |
| `npm run dev` | `CONVEX_AGENT_MODE=anonymous convex dev --tail-logs disable --start 'next dev'` |
| `npm run build` | `next build` |
| `npm run start` | `next start` |
| `npm run test` | `vitest` |
| `npm run lint` | `next lint` |
| `npm run typecheck` | `tsc --noEmit` |

## Troubleshoot a local change

1. Reproduce the smallest example from the [quick-start guide](/docs/up-to-code-w-ai/quick-start-guide).
2. Compare required configuration and dependency versions with the README.
3. Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/w-ai)
- [Original README](https://github.com/Up-to-code/w-ai/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/w-ai/issues)
- [Open the project website](https://w-ai-five.vercel.app)