Canx Starter Basic

🏗️ Full MVC application template for CanxJS with authentication and dashboard.

Features

• ✅ Authentication - Login & Register with session-based auth
• ✅ Dashboard - Protected dashboard page
• ✅ Tailwind CSS - Pre-configured styling
• ✅ Queue Dashboard - Built-in job monitoring at /canx-queue
• ✅ Controller-based Routing - Clean route organization

Quick Start

# Clone or copy this starter
bunx degit chandafa/canx-starters/basic my-app

# Install dependencies
cd my-app
bun install

# Start development server
bun run dev

Project Structure

src/
├── controllers/     # Route controllers
│   ├── AuthController.ts
│   ├── DashboardController.ts
│   └── HomeController.ts
├── views/           # JSX view templates
│   ├── layouts/
│   └── pages/
├── routes.ts        # Route definitions
└── app.ts           # Application entry

Available Scripts

| Command | Description | | ------------------- | ---------------------------------------- | | bun run dev | Start development server with hot reload | | bun run build | Build for production | | bun run start | Run production build | | bun run css:dev | Watch and compile Tailwind CSS | | bun run css:build | Build minified CSS |

Configuration

Create a .env file based on .env.example:

PORT=3000
APP_KEY=your-secret-key
SESSION_SECRET=your-session-secret

Learn More

• CanxJS Documentation
• Queue Dashboard Guide
• Starter Kits Overview

License

MIT