adonis-next-monorepo

adonis-next-monorepo

Creates a working monorepo from template/, a snapshot of a project whose setup was verified end to end. The result is identical in structure, tooling and configuration; only the name and description change. The template's own docs/conventions.md records every convention and why it exists, so read that when the user asks why something is set up the way it is, or wants to change it.

What it creates

• Workspaces: apps/api (AdonisJS 7, Lucid/Postgres, VineJS, token + session auth, Tuyau), apps/web (Next.js 16 App Router, React 19, Tailwind 4, TanStack Query), packages/ui (shadcn on Base UI), packages/eslint-config, packages/typescript-config.
• API structure: feature modules in app/modules/<name>/<name>.{routes,controller,service,validator}.ts, generated by node ace make:module <name>. Starts with auth and health. Every response is { data } or { errors: [...] }, and routes require auth unless marked public.
• Web structure: useQuery(api.<module>.<action>.queryOptions()) rendered through <QueryState>, plus mutation error toasts and env validated with zod.
• Tooling: strict TypeScript 6.0, one ESLint config with custom structure rules, Prettier, Husky + lint-staged + commitlint, branch-name and migration guards, a GitHub Actions CI workflow, Dependabot, VS Code settings, and AI rules in AGENTS.md.

Steps

1. Collect the inputs

You need:

• Name: kebab-case, e.g. acme or my-app. It becomes the @<name>/* package scope; the Postgres user and databases use the snake_case form.
• Title: the display name. Defaults to the name in Title Case.
• Description: one line, used in the README and on the home page.
• Target directory: must be new or empty.

Ask for any missing input in one message. Then confirm the tools exist: node -v (24+), pnpm -v, git --version, and docker info (the Docker daemon must be running; start Docker Desktop if it isn't).

Done when all four inputs are known and every tool responds.