@xylvir/create-xylvir-light

Create a new Xylvir Light project with one command.

Usage

# Using pnpm (recommended)
pnpm create @xylvir/xylvir-light my-app

# Using npx
npx @xylvir/create-xylvir-light my-app

# Using npm
npm create @xylvir/xylvir-light my-app

# Or specify a project name interactively
pnpm create @xylvir/xylvir-light

Requirements

• pnpm - This CLI requires pnpm to be installed globally
• Node.js - Version 18 or higher
• Git - Required for cloning the template

Install pnpm if you haven't already:

npm install -g pnpm

What's included

• ⚡️ Next.js 16 with App Router & Turbopack
• 🔐 Better Auth for authentication (email/password)
• 🎨 Tailwind CSS v4 for styling
• 🧩 shadcn/ui components
• 🛣️ Hono.js API routes
• 🗄️ Prisma ORM with PostgreSQL
• 📦 pnpm workspace ready
• 🎯 TypeScript strict mode
• 🧹 Biome for linting and formatting
• 🪝 Husky for git hooks
• 📝 Conventional Commits with commitlint

Next Steps

After creating your project:

1. Navigate to your project:

   cd my-app

2. Set up your database:

   • Update .env with your DATABASE_URL
   • Example: postgresql://user:password@localhost:5432/dbname

3. Run database migrations:

   pnpm db:migrate

4. Start the development server:

   pnpm dev

5. Visit your app:

   • Open http://localhost:3000

Features

Authentication

• Email/password authentication via Better Auth
• Protected routes with proxy.ts middleware
• Session management
• Login and registration pages

Development Tools

• Hot reload with Turbopack
• Type-safe environment variables
• Prisma Studio for database management
• Biome for code quality

Architecture

• Feature-based organization
• API routes with Hono.js
• Server/client separation
• Type-safe API calls with React Query

Available Scripts

pnpm dev          # Start development server
pnpm build        # Build for production
pnpm start        # Start production server
pnpm lint         # Run linter
pnpm check        # Format and lint
pnpm db:migrate   # Run database migrations
pnpm db:studio    # Open Prisma Studio

Documentation

For more information, visit the Xylvir Light repository.

License

MIT