GitHunt
MD

mdahamshi/top-basic-msg-full

A message app top project

SaraMessage

SaraMessage is a simple, full-stack messaging app built with React, Express, and PostgreSQL. Users can submit, edit, and delete short messages, which are persisted in the backend and displayed in real-time on the frontend.

๐ŸŸข Live Demo: https://link.sarawebs.com/saramsg

Features

  • ๐Ÿ“ Add a new message
  • โœ๏ธ Edit existing messages (if editable)
  • โŒ Delete messages
  • ๐Ÿ“ฆ PostgreSQL-backed data storage
  • ๐Ÿ”„ Real-time list updates via fetch API

Tech Stack

  • Frontend: React + Vite + Tailwind CSS
  • Backend: Node.js + Express
  • Database: PostgreSQL
  • Deployment: Dockerized and self-hosted

Getting Started

1. Clone the Repository

git clone https://github.com/mdahamshi/top-basic-msg-full.git
cd top-basic-msg-full

2. Set Up Environment Variables

Create a .env file in the backend directory with the following:

PORT=3000
POSTGRES_DB=saramsg
SERVICE_USER_POSTGRES=userapp
SERVICE_PASSWORD_POSTGRES=secret

2.5. Set Up docker-compose.override.yml

Create a docker-compose.override.yml for local development:

services:
  server:
    ports:
      - '3000:3000'
  client:
    ports:
      - '8080:80'

3. Run with Docker

docker-compose up --build

The app will be available at http://localhost:8080.

API Endpoints

  • GET /api/messages โ€” Get all messages
  • GET /api/messages/:id โ€” Get a message
  • POST /api/messages โ€” Create a new message
  • PUT /api/messages/:id โ€” Update a message
  • DELETE /api/messages/:id โ€” Delete a message

Screenshots

SaraMessage Screenshot

License

This project is open-source and available under the MIT License.

Languages

JavaScript60.5%CSS26.7%Shell10.2%Dockerfile1.0%TypeScript1.0%HTML0.6%

Contributors

Created August 1, 2025
Updated August 14, 2025
mdahamshi/top-basic-msg-full | GitHunt