https://github.com/mkornajcik/echo

Modern Twitter-like social media app built with Node.js, TypeScript, Express, and EJS.
https://github.com/mkornajcik/echo

aws-s3 docker ejs expressjs javascript jwt-authentication nodejs postgresql prisma supabase typescript

Last synced: 3 months ago
JSON representation

Modern Twitter-like social media app built with Node.js, TypeScript, Express, and EJS.

• Host: GitHub
• URL: https://github.com/mkornajcik/echo
• Owner: mkornajcik
• Created: 2025-05-13T10:07:46.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-07T11:47:42.000Z (12 months ago)
• Last Synced: 2025-08-03T06:37:39.506Z (11 months ago)
• Topics: aws-s3, docker, ejs, expressjs, javascript, jwt-authentication, nodejs, postgresql, prisma, supabase, typescript
• Language: JavaScript
• Homepage: https://social-echo.up.railway.app/
• Size: 1.96 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Echo

Echo is a modern, Twitter-like social media app built with TypeScript, Node.js, Express, and EJS. Host your data on Supabase, assets on AWS S3, and deploy the app seamlessly on Railway.

---

## 📋 Table of Contents

1. [✨ Features](#-features)  

2. [🛠️ Tech Stack](#️-tech-stack)  

3. [🖼️ Screenshots & Demo](#️-screenshots--demo)  

4. [🚀 Getting Started](#-getting-started)  

   - [Prerequisites](#prerequisites)  

   - [Environment Variables](#environment-variables)  

   - [Docker Setup](#docker-setup)  

5. [⚙️ Usage](#️-usage)  

6. [📖 API Documentation](#-api-documentation)  

7. [🌐 Architecture & Hosting](#-architecture--hosting)  

8. [📄 License](#-license)  

9. [✉️ Contact](#️-contact)  

---

## ✨ Features

- 🔄 **Real-Time Messaging** & live feed updates  

- 👥 **Follow / Unfollow** users  

- 📰 **Personalized Feed**  

- 🔔 **Notifications** for mentions, likes, reposts  

- 👤 **User Profiles** with bio, posts, followers  

- 🔍 **Search** posts and users  

---

## 🛠️ Tech Stack

- **Backend:** TypeScript • Node.js • Express  

- **Templating:** EJS  

- **Database:** PostgreSQL (Supabase) • Prisma ORM  

- **Storage:** AWS S3 Buckets  

- **HTTP Client:** Axios  

- **Containerization:** Docker  

- **Hosting:** Railway (app), Supabase (DB), AWS S3 (assets)  

---

## 🖼️ Screenshots & Demo

![HomePage](https://github.com/user-attachments/assets/065390e8-77d0-498c-95f4-d4f611d53210)

![ProfilePage](https://github.com/user-attachments/assets/d310ff18-1ddf-422f-b4c9-565ffb88bb80)

## 🚀 Getting Started

### Prerequisites

- Docker & Docker Compose

- A Supabase project (with your Prisma schema pushed)

- AWS S3 bucket credentials

- Railway account

### Environment Variables

Create a .env file in your project root and set the following:

```

DATABASE_URL=…

PORT=…

JWT_SECRET=…

JWT_EXPIRES_IN=…

JWT_COOKIE_EXPIRES_IN=…

NODE_ENV=production

CLIENT_URL=…

COOKIE_SECRET=…

AWS_ACCESS_KEY_ID=…

AWS_SECRET_ACCESS_KEY=…

AWS_REGION=…

S3_BUCKET_NAME=…

```

### Docker Setup

1. Build & start containers:

```

docker-compose up --build -d

```

2. Run migrations:

```

docker-compose exec app npx prisma migrate deploy

```

3. Access:

  - App at http://localhost:``

  - Supabase DB via Supabase Dashboard

## ⚙️ Usage

- Build the code & copy assets: npm run build

- Start the server: npm start

Your server will run on the port you configured (default 3000).

## 📖 API Documentation

Every endpoint, request schema, and response example is documented here:

https://documenter.getpostman.com/view/35992979/2sB2jAd9BZ

## 🌐 Architecture & Hosting

- **Railway** — Deploys and hosts the Node.js/Express application

- **Supabase** — Managed PostgreSQL database for production data

- **AWS S3** — Stores user‑uploaded files & media assets

## 📄 License

This project is licensed under the **MIT License**.

## ✉️ Contact

Marko Kornajčík

✉️ marko.kornajcik6@gmail.com