Skip to content

aracenasosa/threads-social-network

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

52 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Social Network Project

Welcome to the Social Network monorepo! This project is a modern, full-stack social media application designed with scalability, performance, and best practices in mind, including adherence to SOLID principles.

It consists of two main parts: a high-performance Frontend and a robust Backend.

πŸ—οΈ Project Structure

  • Frontend (Mobile-First Web App)

    • Built with Next.js 16, React 19 and Tailwind CSS.
    • Features optimistic UI updates using TanStack Query.
    • Includes a comprehensive design system with Radix UI primitives.
    • Includes a comprehensive testing system with Jest.
  • Backend (RESTful API)

    • Built with Node.js, Express, and TypeScript.
    • Utilizes MongoDB with Mongoose for data modeling.
    • Implements secure JWT Authentication and Google OAuth.
    • Includes a comprehensive logging system with Winston.
    • Includes a comprehensive testing system with Jest and Supertest.

🎯 Key Design Principles

Both applications are architected following SOLID principles to ensure:

  • Maintainability: Code that is easy to read, understand, and update.
  • Scalability: An architecture that grows with the feature set without accumulating technical debt.
  • Robustness: Strong typing with TypeScript across the entire stack.

πŸš€ Quick Start

To get up and running, you will need to set up both the frontend and backend.

  1. Backend Setup: Go to the backend/ directory and follow the setup instructions to get the API running on port 4000.
  2. Frontend Setup: Go to the frontend/ directory and follow the instructions to start the development server on port 3000.

Check the individual README.md files in each directory for detailed documentation on environment variables, scripts, and architecture deeper dives.

About

A full-stack, theme-responsive social network built with Next.js, Express, and MongoDB. Features nested thread conversations with engagement-based sorting (Top/Recent), multi-file media uploads, user search, and profile customization. Optimized for performance with TanStack Query.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors