Skip to content

A modern, production-ready Django boilerplate for building SaaS applications with HTMX, Tailwind CSS, and Alpine.js. This template provides everything you need to kickstart your next SaaS project with best practices and modern tooling.

License

Notifications You must be signed in to change notification settings

eriktaveras/django-saas-boilerplate

Repository files navigation

Hyperion : Django + HTMX SaaS Boilerplate

Django 5.0 HTMX Tailwind CSS Alpine.js Stripe License: MIT

A modern, production-ready Django boilerplate for building SaaS applications with HTMX, Tailwind CSS, and Alpine.js. This template provides everything you need to kickstart your next SaaS project with best practices and modern tooling.

🌟 Features

  • 🚀 Django 5.0 with modern best practices and security features
  • 🎨 Tailwind CSS for beautiful, responsive designs
  • HTMX for dynamic interactions without complex JavaScript
  • 🎯 Alpine.js for lightweight JavaScript functionality
  • 🔐 User Authentication with django-allauth
  • ✉️ Email Verification system
  • 📱 Responsive Landing Page with modern design
  • 👑 Django Admin Panel customization
  • 💳 Subscription System with Stripe integration
  • 📊 User Dashboard with analytics
  • 🔒 Role-based Access Control
  • 🎨 Modern UI Components
  • 📈 SEO Optimization
  • 🔍 Search Functionality
  • 📱 Mobile-First Approach

🚀 Quick Start

  1. Clone the repository:
git clone https://github.com/eriktaveras/django-saas-boilerplate.git
cd django-saas-boilerplate
  1. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Run migrations:
python manage.py migrate
  1. Create a superuser:
python manage.py createsuperuser
  1. Run the development server:
python manage.py runserver

Visit http://localhost:8000 to see your application!

📁 Project Structure

├── core/                 # Main Django project
│   ├── settings/        # Django settings
│   ├── urls.py         # URL configuration
│   └── wsgi.py         # WSGI configuration
├── apps/                # Django applications
│   ├── accounts/       # User authentication
│   ├── landing/        # Landing page
│   ├── dashboard/      # User dashboard
│   └── subscriptions/  # Subscription management
├── static/             # Static files
│   ├── css/           # CSS files
│   ├── js/            # JavaScript files
│   └── images/        # Image assets
├── templates/          # HTML templates
│   ├── base.html      # Base template
│   ├── components/    # Reusable components
│   └── pages/         # Page templates
└── manage.py          # Django management script

🛠️ Technology Stack

  • Backend: Django 5.0
  • Frontend: HTMX, Alpine.js
  • Styling: Tailwind CSS
  • Database: PostgreSQL (recommended)
  • Authentication: django-allauth
  • Payments: Stripe
  • Email: SendGrid (recommended)

🤝 Contributing

We love your input! We want to make contributing to Django SaaS Boilerplate as easy and transparent as possible. Please see our Contributing Guide for details.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Maintainer

Erik Taveras

Erik Taveras - Full Stack Solutions Developer

Specialized in Python, Django, and building scalable web applications and API solutions for businesses and startups.

🙏 Acknowledgments

Star History

Star History Chart

📫 Contact & Support

If you have any questions or suggestions, please:

Built with ❤️ by Erik Taveras

About

A modern, production-ready Django boilerplate for building SaaS applications with HTMX, Tailwind CSS, and Alpine.js. This template provides everything you need to kickstart your next SaaS project with best practices and modern tooling.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published