Código públicoPython / Django
SocialStarter
Una plantilla de Django para construir una red social.
Trae las piezas base de una red social: publicaciones, feed, seguidores, likes, comentarios, mensajes directos y notificaciones en tiempo real. Sirve para arrancar un producto o para estudiar cómo funciona una red social por dentro.
- Estrellas
- 30
- Forks
- 14
- Lenguaje
- Python / Django
- Licencia
- Sin licencia (todos los derechos reservados)
- 30
- estrellas en GitHub
- 14
- forks del repositorio
- 9
- apps de Django, una por responsabilidad
- 2024
- año en que se publicó el código
El reto
Quien quiere lanzar una comunidad propia, o entender cómo funciona una red social por dentro, se encuentra con muchas piezas que dependen unas de otras: cuentas, seguidores, publicaciones, likes, comentarios, mensajes y avisos. Empezar de cero significa semanas resolviendo lo mismo que ya resolvieron todas las redes.
Los tutoriales suelen cubrir una pieza suelta, como un feed o un login, pero no cómo se conectan todas en un mismo proyecto.
Lo que construimos
SocialStarter separa cada responsabilidad en su propia app de Django: users, relationship, posts, feed, interactions, messaging, notifications y settings. Cada una tiene sus modelos y vistas, y se conectan entre sí sin mezclarse, así es fácil leer el código o reemplazar una parte.
El acceso usa django-allauth. Las publicaciones aceptan texto, imagen o video, y el feed carga de cinco en cinco a medida que bajas. Los seguidores funcionan con solicitudes que se aceptan, y los mensajes directos se agrupan en conversaciones con bandeja de entrada y contador de no leídos.
Las notificaciones llegan en tiempo real: un consumer de Django Channels abre un grupo por usuario por WebSocket y empuja cada aviso y el contador sin recargar la página. La interfaz usa Tailwind y Alpine.js, sin un framework de frontend aparte.
PARA QUIÉN SIRVE
- Desarrolladores que quieren una base en Django para una comunidad, un foro social o una red interna, sin escribir desde cero seguidores, mensajes y avisos.
- Estudiantes y equipos que quieren ver cómo se conectan las piezas de una red social en un proyecto real y legible.
QUÉ HACE
- Registro y login con django-allauth.
- Publicaciones con texto, imagen o video y un feed con carga progresiva.
- Likes y comentarios en cada publicación.
- Seguidores con solicitudes que se aceptan.
- Mensajes directos entre usuarios, con bandeja de entrada y conversaciones.
- Notificaciones en tiempo real por WebSocket con Django Channels, y ajustes de tema, idioma y privacidad.
Cómo está armado
- Cuentas y relaciones django-allauth para el acceso y la app relationship para seguir y aceptar solicitudes.
- Publicaciones y feed Las apps posts y feed guardan el contenido y lo sirven en orden cronológico, de cinco en cinco.
- Interacciones La app interactions maneja likes y comentarios sobre cada publicación.
- Mensajería La app messaging agrupa los mensajes en conversaciones entre participantes.
- Notificaciones Un consumer de Django Channels abre un grupo por usuario y empuja los avisos y el contador de no leídos.
Stack
DjangoPythonWebSocketsTailwindAlpine.jsRedis
Por qué lo hicimos
Nació como plantilla para crear redes sociales y como material para entender cómo funcionan por dentro, separando cada responsabilidad en su propia app.
Cómo empezar
git clone https://github.com/eriktaveras/SocialStarter.git && cd SocialStarter
pip install -r requirements.txt
python manage.py migrate && python manage.py createsuperuser
python manage.py runserver
LO QUE APRENDIMOS
- Una app de Django por responsabilidad hace que el proyecto se entienda leyendo la lista de carpetas, y deja cambiar una pieza sin tocar las demás.
- El tiempo real cambia la infraestructura: las notificaciones por WebSocket piden Django Channels y Redis en producción, no solo un servidor web.
- Al usar nombres genéricos en las vistas hay que cuidar los choques: pasar una variable llamada messages a la plantilla tapa los avisos del framework de mensajes de Django.
Necesitas algo así a la medida?
Usamos estas mismas herramientas en los proyectos de nuestros clientes.
Otros proyectos open source
- Starter de SaaS django-saas-boilerplate Starter de SaaS con Django 6: login por correo, suscripciones con Stripe, dashboard, CSP y 67 pruebas. Listo para desplegar.
- 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.



