MITStarter de SaaS
django-saas-boilerplate
Un starter de SaaS con Django 6, terminado y listo para desplegar.
Trae lo que todo SaaS necesita el primer día: registro, login por correo, dashboard, cobros con Stripe y un sitio público. Así se empieza a construir el producto en vez de pasar semanas configurando.
- Estrellas
- 252
- Forks
- 70
- Lenguaje
- Python / Django
- Licencia
- MIT
- 252
- estrellas en GitHub
- 70
- forks de desarrolladores que lo usan como base
- 67
- pruebas automatizadas, con Stripe simulado
- MIT
- licencia: úsalo, cámbialo y véndelo sin atribución
El reto
Todo SaaS nuevo pierde sus primeras semanas en lo mismo: cuentas de usuario, verificación de correo, recuperación de contraseña, suscripciones, el webhook de Stripe, cabeceras de seguridad y el despliegue. Nada de eso es el producto, pero sin eso no se puede cobrar el primer peso.
Las plantillas que circulan suelen prometer más de lo que hacen. La primera versión de este mismo repositorio lo demostró: con las dependencias sin fijar, una instalación nueva traía una versión de Stripe que rompía el checkout, y la clave secreta y la contraseña del admin de ejemplo estaban publicadas en el repositorio.
Lo que construimos
Construimos un starter pequeño y terminado sobre Django 6: usuario propio con login solo por correo (django-allauth, 21 plantillas con estilo), un panel con perfil, ajustes y llaves de API que se guardan con hash SHA-256 y se muestran una sola vez, planes administrables con periodo de prueba, y páginas públicas de inicio, funciones y precios.
Los cobros van con la Payment Methods API de Stripe, versión de API fijada y webhook firmado. El pago y el acceso quedan sincronizados: pagar activa el plan y cancelar cancela en Stripe, no solo en la base de datos. La Content Security Policy nativa de Django 6 trabaja con nonces y deja pasar a Stripe para que la verificación 3-D Secure funcione.
Las decisiones van por la simplicidad: Tailwind y Alpine desde CDN para que la instalación sea un solo comando, correos con el @task() nativo de Django 6, SQLite en desarrollo y PostgreSQL por DATABASE_URL en producción, con Gunicorn y WhiteNoise listos para Railway, Heroku o un VPS. El README dice con la misma claridad lo que no incluye: equipos, límites por plan, API REST ni Docker.
Cómo se ve
PARA QUIÉN SIRVE
- Desarrolladores que van a lanzar un SaaS con Django y no quieren rehacer cuentas, pagos y despliegue.
- Equipos pequeños y agencias que necesitan una base probada para el MVP de un cliente.
- Quien está aprendiendo Django y quiere ver cómo se conecta Stripe con webhooks, CSP y pruebas en un proyecto real.
QUÉ HACE
- Usuario propio con login solo por correo, verificación y recuperación de contraseña con django-allauth, en 21 plantillas con estilo.
- Suscripciones con Stripe: Payment Methods API, versión de API fijada y webhook firmado.
- Dashboard con perfil, ajustes de notificaciones y llaves de API que se guardan con hash y se muestran una sola vez.
- Planes administrables desde el admin, con periodo de prueba, y páginas públicas de inicio, funciones y precios.
- Content Security Policy nativa de Django 6 con nonces, HSTS y cookies seguras en producción.
- 67 pruebas que cubren cuentas, dashboard, landing, checkout y webhook de Stripe, con Stripe simulado.
Cómo está armado
- Cuentas CustomUser con login por correo y django-allauth para registro, verificación y contraseñas.
- Suscripciones La app subscriptions crea el checkout y recibe el webhook firmado que actualiza el estado del usuario.
- Dashboard y landing Plantillas Django con Tailwind, Alpine.js y HTMX, sin paso de compilación.
- Tareas Los correos salen con @task() nativo de Django 6, ejecutado al momento con ImmediateBackend.
- Despliegue Gunicorn, WhiteNoise y Procfile; SQLite en desarrollo y PostgreSQL por DATABASE_URL en producción.
Stack
DjangoPythonStripePostgreSQLHTMXTailwindAlpine.js
Por qué lo hicimos
Es la versión abierta de DjangoBlaze: muestra cómo Taveras Solutions entrega un producto con alcance acotado a propósito, probado y con sus límites documentados.
Cómo empezar
git clone https://github.com/eriktaveras/django-saas-boilerplate.git
cd django-saas-boilerplate && make install
cp .env.example .env && make migrate && make seed
make run # abre http://localhost:8000
LO QUE APRENDIMOS
- Fijar versiones es parte del producto. Una dependencia sin rango rompió el checkout meses después, en la máquina de otra persona; ahora cada paquete está fijado al rango que las pruebas cubren.
- En un repositorio público, cualquier valor por defecto es un valor publicado. La clave secreta y la contraseña del admin dejaron de tener valores fijos, y la release v1.1.0 explicó a quien ya lo había desplegado qué rotar.
- Decir lo que falta genera más confianza que prometer de más. El README lista lo que el starter no hace, para que cada quien decida qué construir encima.
Necesitas algo así a la medida?
Usamos estas mismas herramientas en los proyectos de nuestros clientes.
Otros proyectos open source
- Facturas con IA InvoiceFlow Facturas con IA para República Dominicana: OCR, alertas fiscales de la DGII (ITBIS, fechas, datos del 606), facturas por WhatsApp y exportación del 606.
- App para macOS ModelNap App de barra de menú que duerme los modelos locales de Ollama cuando no los usas y le devuelve la memoria a tu Mac. Firmada y notarizada.
- Python / Django SocialStarter Plantilla para crear redes sociales con Django: perfiles, feeds y notificaciones.