A full-stack social media application built for real-time content sharing and interaction.

This was one of the first FullStack projects I created, it's purpose was to tie everything I learned from The Odin Project's course together in a relatively complex project. Social media apps are among the most widely used applications on the web today.

• Authentication with username/password AND Github Auth (cookies based).
• Real time interaction updates (posts, follow requests, comments, likes).
• Image sharing capability.
• User connection and interaction.

• Javascript
• React
• Vite
• Vercel
• Socket.IO

• Express
• Nodejs
• PostgreSQL
• Prisma ORM
• Socket.IO
• Cloudinary
• OnRender
• Neon

• Node.js
• npm
• PostgreSQL (ensure your database is running)
• Basic knowledge of using a terminal (steps are beginner-friendly)

git clone https://github.com/3antozz/Odin-Book
cd Odin-Book

cd api
npm install

1- Create a .env file in the api/ directory (based on .env.example) and fill in the required environment variables such as:

• Database connection URL
• Session secret
• Cloudinary credentials
• Github Tokens (if available)

2- Start the backend server:

npm start

1- Open a new terminal window or tab:

cd client
npm install
npm run dev

2- Rename the .env.example file to .env in the client/ directory

1- Once both servers are running:

2- Visit http://localhost:5173 in your browser

• Lucide React – Import Icons.
• react-virtuoso – React component that displays large data sets using virtualized rendering (render when visible in viewport).
• Socket.IO – Low-latency, bidirectional and event-based communication between a client and a server for real time updates.
• date-fns – Used for manipulating JavaScript dates.

• bcryptjs – For securing passwords by hashing and salting.
• express-session – Simple session middleware for Authenticating.
• prisma/client – ORM - Auto-generated and type-safe query builder for Node.js.
• prisma-session-store – An express session store implementation for the Prisma ORM.
• passport – Express-compatible authentication middleware for Node.js.
• passport-local – This module lets you authenticate using a username and password in your Node.js applications.
• passport-github2 – This module lets you authenticate using GitHub OAuth 2.0 in your Node.js applications.
• express-validator – User input validation middleware.
• cloudinary – Images storage service integration.
• multer – Node.js middleware for handling multipart/form-data, used for uploading files.
• express-async-handler – Asynchronous exception-handling middleware.
• Socket.IO – Low-latency, bidirectional and event-based communication between a client and a server for real time updates.
• cors – Package for providing a Connect/Express middleware that can be used to enable CORS.