Laju Go

High-performance SaaS boilerplate built with Go Fiber + Svelte 5 + Inertia.js 3 + SQLite.

Build production-ready web applications faster with a clean, layered architecture that combines the speed of Go with the developer experience of modern frontend frameworks.

🚀 Quick Start

Option 1: Using create-laju-go CLI (Recommended)

# Create new project with CLI
npx create-laju-go my-app

# Navigate to project
cd my-app

# Start development
npm run dev:all

Option 2: Clone Repository

# Clone the repository
git clone https://github.com/maulanashalihin/laju-go.git
cd laju-go

# Install dependencies
go mod download && npm install

# Set up environment
cp .env.example .env

# Start development servers
npm run dev:all

Visit http://localhost:8080 to see your application running.

✨ Features

Authentication & Security

• Email/Password Authentication - Secure login with bcrypt password hashing
• Google OAuth 2.0 - One-click social login integration
• Password Reset - Email-based password recovery with secure tokens
• Session Management - Database-backed persistent sessions
• CSRF Protection - Built-in cross-site request forgery prevention
• Rate Limiting - Configurable request throttling for sensitive endpoints

User Management

• Role-Based Access Control - Admin/User roles with middleware guards
• Profile Management - Update profile, change password, avatar upload
• File Upload - Avatar upload with validation and secure storage

Development Experience

• Hot Module Replacement - Vite HMR for instant frontend updates
• Go Hot Reload - Air automatically rebuilds on Go file changes
• Clean Architecture - Separated layers (handlers, services, repositories)
• TypeScript Ready - Full type safety in frontend code

Production Ready

• SQLite Optimized - WAL mode, connection pooling, production-tuned
• Database Migrations - Goose-based schema version control
• Docker Support - Multi-stage builds for efficient containerization
• Systemd Ready - Production deployment with process management

📚 Documentation

📁 Project Structure

laju-go/
├── main.go                    # Application entry point
├── app/                       # Backend Go code
│   ├── handlers/              # HTTP request handlers
│   ├── services/              # Business logic layer
│   ├── repositories/          # Database access layer
│   ├── middlewares/           # Request middleware
│   └── models/                # Data structures
├── frontend/                  # Svelte 5 frontend
│   └── src/
│       ├── components/        # Reusable UI components
│       ├── pages/             # Page components
│       └── lib/               # Utilities and helpers
├── routes/                    # Route definitions
├── migrations/                # Database migrations
├── templates/                 # HTML templates
└── docs/                      # Documentation

📖 See Project Structure for a complete directory reference.

🛠️ Tech Stack

📦 Installation

Prerequisites

• Go 1.26 or higher
• Node.js 18 or higher
• SQLite3 (usually pre-installed on macOS/Linux)
• Git for version control

Method 1: Using create-laju-go CLI (Recommended)

The easiest way to create a new Laju Go project:

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

# Navigate to project
cd my-app

# Install Air for hot reload (recommended)
go install github.com/air-verse/air@latest

# Start development
npm run dev:all

The CLI will:

• Check for Go and Git installation
• Let you choose package manager (npm, yarn, bun)
• Clone the template from GitHub
• Install all dependencies
• Set up environment configuration

Method 2: Manual Installation

1. Clone the repository

   git clone https://github.com/maulanashalihin/laju-go.git
   cd laju-go
   

2. Install Go dependencies

   go mod download
   

3. Install Node.js dependencies

   npm install
   

4. Configure environment

   cp .env.example .env
   

   Edit .env with your settings. At minimum, set:

   APP_ENV=development
   SESSION_SECRET=your-32-character-secret-key
   

5. Set up Google OAuth (Optional)

   • Go to Google Cloud Console
   • Create a new project and enable Google+ API
   • Create OAuth 2.0 credentials
   • Add http://localhost:8080/auth/google/callback to authorized redirect URIs
   • Copy Client ID and Secret to .env

6. Set up Email/SMTP (Optional - for password reset)

   • Configure SMTP settings in .env
   • For Gmail, use an App Password

🏃 Development

Option 1: Run Everything Together (Recommended)

Start both Vite and Go servers with hot reload:

npm run dev:all

Option 2: Run Servers Separately

Terminal 1 - Vite dev server (frontend HMR):

npm run dev

Terminal 2 - Go server with hot reload:

air
# Or via npm
npm run dev:go

Option 3: Manual Run

# Go server (manual restart after changes)
go run main.go

# Vite dev server
npm run dev

Available Scripts

# Development
npm run dev          # Start Vite dev server
npm run dev:go       # Start Go server with Air hot reload
npm run dev:all      # Run both Vite and Air concurrently

# Production
npm run build        # Build frontend and Go binary
npm run serve        # Run production binary

# Testing
npm run test:run     # Run frontend tests

Development Workflow

🚀 Production Deployment

Quick Deploy

# Build frontend assets
npm run build

# Build Go binary
go build -o laju-go .

# Run the server
./laju-go

Docker Deployment

# Build the image
docker build -t laju-go .

# Run the container
docker run -p 8080:8080 \
  -v $(pwd)/data:/root/data \
  -v $(pwd)/storage:/root/storage \
  laju-go

Ubuntu/Debian Server

For complete production deployment instructions including systemd service setup, Nginx reverse proxy, and SSL configuration, see Production Deployment Guide.

🔐 Default Admin Setup

After your first registration, promote your user to admin via SQLite:

sqlite3 data/app.db "UPDATE users SET role = 'admin' WHERE email = '[email protected]';"

🗄️ Database Migrations

Migrations run automatically on startup. Manual commands:

# Install goose
go install github.com/pressly/goose/v3/cmd/goose@latest

# Run all migrations
goose -dir migrations sqlite3 data/app.db up

# Check migration status
goose -dir migrations sqlite3 data/app.db status

# Rollback last migration
goose -dir migrations sqlite3 data/app.db down

🧪 Testing

# Run all tests
go test ./...

# Run tests with coverage report
go test -cover ./...

📊 Performance Optimizations

SQLite Production Settings

The application includes these optimizations by default, tuned for Vultr High Frequency 1-2GB RAM:

Tune for Your Server

Different RAM size? See the complete SQLite Configuration Guide for optimal settings:

📖 Full guide: SQLite Configuration Guide - Complete reference for tuning SQLite based on RAM, CPU, storage type, and workload patterns.

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

• Go Fiber - Fast web framework
• Svelte - Cybernetically enhanced web apps
• Inertia.js - Server-driven SPA
• Tailwind CSS - Utility-first CSS
• Lucide Icons - Beautiful, consistent icons

📞 Support

• Documentation: docs/ folder
• Issues: GitHub Issues
• Discussions: GitHub Discussions