Laju

⚡ High-performance TypeScript web framework - 11x faster than Express.js

Build modern full-stack applications with HyperExpress, Svelte 5, and Inertia.js.

🚀 Quick Start

# Create new project
npx create-laju-app my-project
cd my-project

# Setup database
npm run migrate

# Start development
npm run dev

Visit http://localhost:5555

Want AI to build everything? Use multi-agent workflow with mandatory review points:

@workflow/agents/product.md  Saya mau bikin aplikasi [deskripsikan]

Agents: product.md → tech-lead.md → developer.md → qa.md → devops.md

✨ Features

Performance First

• 258,611 req/sec - HyperExpress server (11x faster than Express)
• 19.9x faster writes - SQLite with WAL mode
• Zero-config caching - Database cache included (optional Redis)

Modern Stack

• Svelte 5 - Reactive UI with runes
• Inertia.js - SPA without client-side routing
• TailwindCSS 4 - Utility-first CSS with Vite
• TypeScript 6.0 - Full type safety

Built-in Services

• Authentication - Sessions, OAuth (Google), password reset
• Storage - S3/Wasabi with presigned URLs
• Email - Nodemailer (SMTP) or Resend (API)
• Caching - Database cache or Redis
• Templates - Eta for SSR

AI Development

• Product Agent - Define requirements, PRD, user stories
• Tech Lead Agent - Design system architecture, database schema
• Developer Agent - Implement features with mandatory review
• QA Agent - Test and review before deploy
• DevOps Agent - Deploy to production

📊 Performance

Benchmark: Simple JSON response on same hardware

📚 Documentation

Complete Documentation →

Documentation is organized for progressive learning from beginner to advanced.

Quick Start

• 5-Minute Quick Start - Get running in 5 minutes
• Introduction - Framework overview, tech stack
• Project Structure - Directory layout, conventions

Core Features

• Database Guide - Kysely + SQLite, WAL mode, migrations
• Routing & Handlers - Routes, handlers, request/response
• Frontend (Svelte 5) - Runes, State, Forms, Inertia.js
• Authentication - Sessions, OAuth, password reset
• Middleware - Auth, rate limiting, custom middleware
• Validation - Zod schemas, input validation
• Email - Nodemailer, Resend, email templates

Advanced Features

• Storage (S3) - S3/Wasabi, presigned URLs, file uploads
• Caching - Database cache vs Redis, strategies
• Redis - Redis configuration and usage
• Background Jobs - Cron jobs, task scheduling
• CSRF Protection - Token generation, form protection
• Translation (i18n) - Multi-language support
• Eta Templates - SSR, partials, helpers

Production Ready

• Best Practices - Code organization, patterns
• Security Guide - Authentication, XSS, CSRF, CSP
• Performance Guide - Database, caching, optimization
• Testing - Unit, integration, Vitest, Playwright
• Deployment - Production build, PM2, HTTPS
• GitHub Actions - CI/CD workflows
• Backup & Restore - Database backup automation

Advanced Topics

• AI Development - Build with AI assistants
• API Reference - Complete API documentation
• TypeScript Guide - TypeScript configuration, strict mode
• Tailwind CSS Migration - Migrate between v3/v4
• Migration Guide - Migration patterns
• Troubleshooting - Common issues and solutions

Project Structure

app/
├── handlers/        # Request handlers (domain-based)
├── middlewares/     # Auth, rate limiting, CSRF
├── services/        # DB, Mailer, Storage, Cache
├── repositories/    # Database query layer
└── validators/      # Input validation

frontend/
├── src/
│   ├── Pages/       # Svelte/Inertia pages
│   ├── Components/  # Reusable components
│   ├── app.js       # Main entry point
│   ├── index.js     # Secondary entry point
│   └── index.css    # TailwindCSS

templates/           # Eta templates (SSR)
├── index.html       # Landing page template
├── inertia.html     # Inertia.js base template
└── partials/        # Template partials

routes/              # Route definitions
migrations/          # Database migrations
commands/            # CLI commands
tests/               # Unit & integration tests
docs/                # Documentation
benchmark/           # Performance benchmarks
public/              # Static assets
storage/             # Local storage
data/                # SQLite databases
type/                # TypeScript definitions

Commands

# Development
npm run dev                              # Start dev server (Vite + Nodemon)

# Production
npm run build                            # Build for production
node build/server.js                     # Run production server

# Database
npm run migrate                          # Run all migrations
npm run migrate:down                     # Rollback last migration
npm run migrate:down 3                   # Rollback 3 migrations
npm run migrate:down 20230514062913      # Rollback to specific migration
npm run migrate:rollback                 # Rollback to last batch
npm run refresh                          # Drop and re-migrate database

# Testing
npm run test:run                         # Run unit/integration tests (Vitest)
npm run test:ui                          # Run tests with UI
npm run test:coverage                    # Run tests with coverage
npm run test:e2e                         # Run E2E tests (Playwright)
npm run test:e2e:ui                      # Run E2E tests with UI
npm run test:e2e:debug                   # Run E2E tests in debug mode

# Code Generation
npx tsx commands/native/MakeController.ts UserController    # Generate controller
npx tsx commands/native/MakeCommand.ts CustomCommand        # Generate command
npx tsx commands/native/MakeHandler.ts UserHandler          # Generate handler
npx tsx commands/native/MakeMiddleware.ts AuthMiddleware    # Generate middleware
npx tsx commands/native/MakeRepository.ts UserRepository    # Generate repository
npx tsx commands/native/MakeValidator.ts AuthValidator      # Generate validator

Tech Stack

Author

Maulana Shalihin - [email protected]

• maulanabuilds.com - Senior Full-Stack Engineer, MVP Development

Support

• Star this repository
• Become a Sponsor
• Report bugs via GitHub Issues

License

MIT License