A modern, opinionated full-stack framework for building Next.js applications with enterprise-grade features built-in.
Features • Quick Start • Documentation • Deployment • Contributing
MarieJS is a comprehensive framework that brings Laravel-inspired conventions and productivity to the Next.js ecosystem. It provides everything you need to build production-ready applications with authentication, database management, queues, notifications, and more.
- 🔐 Authentication - NextAuth.js integration with built-in auth pages
- 🗄️ Database Layer - Type-safe SQLite with NOORMME ORM, Kysely query builder, and migrations
- 📊 Admin Dashboard - Complete admin panel with system health monitoring
- 🎨 Modern UI - Tailwind CSS with pre-built components
- 📬 Queue System - Background job processing
- 🔔 Notifications - Multi-channel notification system
- 💳 Payment Integration - Subscription and payment handling
- 🛠️ MCP Server - Model Context Protocol server for AI-powered development
- 🚀 Developer Experience - Artisan-like CLI commands and scaffolding
Create a new MarieJS application:
npx create-mariejs-app my-app
cd my-app
npm installSet up your environment:
cp env.example .env
# Edit .env with your configuration (SQLite database will be created automatically)Run migrations:
npm run migrateStart the development server:
npm run devVisit http://localhost:3000 to see your application!
MarieJS/
├── mcp-servers/ # MCP server for AI-assisted development
│ └── marie-artisan/ # Artisan-style CLI commands
├── packages/ # NPM packages
│ └── create-mariejs-app/ # Project scaffolding tool
├── templates/ # Project templates
│ └── mariejs/ # Main application template
└── rules/ # Development guidelines
MarieJS includes a Model Context Protocol (MCP) server that provides AI-powered development tools:
- Project scaffolding - Generate new projects with best practices
- Database commands - Run migrations and seed data
- Code analysis - Analyze and optimize your codebase
To use the MCP server with Cursor or other AI tools, see the MCP documentation.
- Next.js 15 - React framework with App Router
- TypeScript - Type safety and better DX
- Tailwind CSS - Utility-first CSS framework
- NextAuth.js - Authentication for Next.js
- SQLite - Lightweight, file-based relational database
- NOORMME - Modern ORM for Node.js
- Kysely - Type-safe SQL query builder
Pre-built authentication with sign-in, sign-up, and protected routes using NextAuth.js.
Type-safe database layer with:
- SQLite with NOORMME ORM
- Kysely query builder for type-safe queries
- Migration system
- Repository pattern with caching
- Health checks and optimization tools
Complete admin interface with:
- System health monitoring
- User management
- Audit logs
- Database optimization tools
- Real-time statistics
Simple in-memory background job processing with:
- Job registration and handlers
- Automatic retries
- Job status tracking
- Built-in handlers for common tasks (email, image processing)
Pre-built, accessible components:
- Buttons
- Cards
- Forms
- Badges
- And more...
MarieJS applications can be deployed to:
- Vercel (recommended)
- AWS
- Google Cloud
- Any Node.js hosting platform
See the Deployment Guide for detailed instructions.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
MarieJS is inspired by:
- Laravel - For its elegant conventions
- Next.js - For the amazing React framework
- The KonMari Method - For its organizational principles
- 📫 Issues: GitHub Issues
- 📖 Documentation: Check the docs folder in each package
- 🌟 Star this repo if you find it helpful!
Built with ❤️ for developers who value productivity and clean code.