Saltar al contenido
Taveras Solutions · Ir al inicio
Agendar diagnóstico

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
Página de inicio del starter: titular «The SaaS starter kit you wish you had» con botones para empezar y ver el código en GitHub.
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

Página de inicio pública del starter con el titular y los botones de empezar y ver en GitHub.
La página pública viene hecha: inicio, funciones y precios, sin paso de compilación.
Formulario de inicio de sesión con correo y contraseña, recordarme y enlace para recuperar la contraseña.
Login solo por correo, con verificación y recuperación de contraseña de django-allauth.
Panel del usuario de demo con tarjetas de usuarios, proyectos y plan, actividad reciente y acciones rápidas.
El panel con barra lateral, actividad reciente y generación de llaves de API.
Página de planes dentro del panel con Free, Pro y Enterprise y el botón para iniciar la prueba de 14 días.
Planes administrables desde el admin, con periodo de prueba de 14 días.
Página de suscripción con el campo de tarjeta de Stripe y el botón de suscribirse.
El checkout usa Stripe Elements; el webhook firmado actualiza el acceso del usuario.

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

  1. Cuentas CustomUser con login por correo y django-allauth para registro, verificación y contraseñas.
  2. Suscripciones La app subscriptions crea el checkout y recibe el webhook firmado que actualiza el estado del usuario.
  3. Dashboard y landing Plantillas Django con Tailwind, Alpine.js y HTMX, sin paso de compilación.
  4. Tareas Los correos salen con @task() nativo de Django 6, ejecutado al momento con ImmediateBackend.
  5. 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.