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

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)
Feed de SocialStarter con el cuadro para publicar, una publicación con comentarios y la barra lateral de accesos rápidos.
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.

Cómo se ve

Feed con publicaciones de usuarios de demostración, likes y comentarios.
El feed: publicar, comentar y dar like desde la misma pantalla.
Perfil con portada, avatar, biografía, contadores de publicaciones y seguidores, y botones de seguir y mensaje.
Perfil con portada, seguidores y acceso directo a mensajes.
Lista de notificaciones de likes, comentarios, seguidores y mensajes, con un ícono por tipo.
Avisos por tipo, que llegan en vivo por WebSocket.
Conversación de mensajes directos entre dos usuarios de demostración.
Mensajes directos agrupados en conversaciones.

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

  1. Cuentas y relaciones django-allauth para el acceso y la app relationship para seguir y aceptar solicitudes.
  2. Publicaciones y feed Las apps posts y feed guardan el contenido y lo sirven en orden cronológico, de cinco en cinco.
  3. Interacciones La app interactions maneja likes y comentarios sobre cada publicación.
  4. Mensajería La app messaging agrupa los mensajes en conversaciones entre participantes.
  5. 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.