Guides
Use and adapt w-ai
Use and adapt w-ai: W-AI multi-tenant website builder and domain platform
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
pnpm install
cp .env.example .env.local
pnpm devCommands in the root manifest
The captured 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
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- 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
Source captured: 2026-10-11