GitHub - Staxless/staxless

GitHub

2 min read Original article ↗

Build Simple. Scale Smarter.

License Node Docker

The production-ready SaaS boilerplate for modern applications.

Features

  • Frontend - Next.js with React, Tailwind CSS, and shadcn/ui
  • Microservices - Node.js with Express for auth, users, payments, and email
  • API Gateway - Kong for routing and rate limiting
  • Authentication - Lucia with OAuth2 (Google, GitHub)
  • Payments - Stripe subscriptions and one-time purchases
  • Database - MongoDB for scalable data management
  • Containerized - Docker Compose with hot reloading

Quick Start

# Install the CLI
npm install -g @staxless/cli

# Initialize your project
staxless init

# Start development
staxless dev start

Visit http://localhost:3000

Tech Stack

Component Technology
Frontend Next.js, React, Tailwind CSS, shadcn/ui
Backend Node.js, Express, MongoDB
API Gateway Kong
Payments Stripe
Authentication Lucia, OAuth2
DevOps Docker, Docker Compose

Project Structure

staxless/
├── microservices/
│   ├── frontend/          # Next.js application
│   │   ├── src/
│   │   │   ├── app/       # Next.js App Router
│   │   │   └── components/
│   │   │       ├── sales/ # Landing page sections
│   │   │       ├── shared/# Header, Footer
│   │   │       └── ui/    # shadcn components
│   │   └── config/        # Brand & sales config
│   ├── auth-service/      # Authentication
│   ├── user-service/      # User management
│   ├── stripe-service/    # Payments
│   └── email-service/     # Transactional email
├── kong-gateway/          # API Gateway config
├── docker/                # Docker configurations
└── environments/          # Environment templates

Services

Service Port Description
Frontend 3000 Next.js application
API Gateway 8000 Kong API Gateway
Auth Service 8080 Authentication & OAuth
User Service 8082 User management
Stripe Service 8083 Payments & subscriptions
Email Service 8084 Transactional email
MongoDB 27017 Database

Configuration

Frontend Customization

# Configure branding and styles
staxless setup:frontend

Or edit directly:

  • frontend/config/brand-config.ts - Colors, typography, company info
  • frontend/config/sales-config.ts - Landing page copy, testimonials, pricing

Environment Variables

Copy templates and configure:

cp environments/template.env environments/.env

Required variables:

  • STRIPE_PRIVATE_KEY - Stripe API key
  • GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET - OAuth
  • GH_OAUTH_CLIENT_ID / GH_OAUTH_CLIENT_SECRET - OAuth
  • MONGODB_URI - Database connection

Development

# Start all services
staxless dev start

# View logs
staxless dev logs -f

# Check status
staxless dev status

# Stop services
staxless dev down

# Full reset
staxless dev reset

Deployment

# Configure production secrets
staxless setup:prod

# Deploy to production
staxless prod deploy

# Check deployment status
staxless prod status

Prerequisites

Links