Interactive CLI for scaffolding Solithix-flavored Next.js + Convex projects.
- Full Next.js App Router project with TypeScript and Tailwind CSS
- Convex backend setup (real-time database, functions, auth)
- shadcn/ui component library pre-configured
- Feature-based architecture with clear module boundaries
- Jotai for feature-level state management
- Opinionated project structure, conventions, and docs baked in
npx @solithix/drafts@latest initFollow the interactive prompts to scaffold a new project.
Creates a new Solithix project from scratch. Runs a 10-step scaffold:
- Bootstraps a Next.js app via
create-next-app - Initializes shadcn/ui
- Installs dependencies (Convex, Jotai, etc.)
- Writes config files
- Generates documentation
- Sets up AI agent files
- Scaffolds the
src/directory structure - Configures Convex
- Marks the project as a Solithix project in
package.json - Initializes git
Generates a new feature module inside src/features/. Each feature follows this structure:
features/[name]/
api/ # Data fetching hooks
components/ # Feature-specific UI
hooks/ # Business logic hooks
store/ # Jotai state atoms
types.ts # TypeScript types
index.ts # Public exports
Generates a new page/route inside src/app/.
Generates a new shared component.
Note: The
addsubcommands must be run from inside a Solithix project (detected via asolithixkey inpackage.json).
src/
app/ # Next.js App Router (routes)
features/ # Feature modules (business domains)
components/ui/ # Shared UI primitives
lib/ # Utilities, error handling
hooks/ # Shared hooks
convex/
schema.ts # Database schema
http.ts # HTTP routes (webhooks)
crons.ts # Scheduled jobs
_helpers/ # Shared utilities
[entity].ts # Backend functions by entity
| Layer | Technology |
|---|---|
| Frontend | Next.js, React, TypeScript, Tailwind |
| UI | shadcn/ui |
| Backend | Convex (real-time DB, functions, auth) |
| State | Jotai (feature), Convex (server), URL |
See CONTRIBUTING.md for development setup and guidelines.
See CHANGELOG.md for release history.
MIT © 2026 Solithix