Skip to content

Latest commit

Β 

History

History
97 lines (67 loc) Β· 1.98 KB

File metadata and controls

97 lines (67 loc) Β· 1.98 KB

reGive ♻️

reGive is a community-driven web platform that connects people who want to donate items they no longer need with those who can put them to good use β€” giving things a second life instead of sending them to a landfill.

🌐 Live Demo: regive.onrender.com


✨ Features

  • Browse and post items available for donation
  • User authentication and profiles
  • Clean, server-rendered UI powered by EJS
  • Responsive design for desktop and mobile

πŸ›  Tech Stack

Layer Technology
Runtime Node.js
Framework Express.js
Templating EJS (Embedded JavaScript)
Styling CSS
Backend Hosting Render
Frontend Hosting Vercel
CI/CD GitHub Actions

πŸ“ Project Structure

reGive/
β”œβ”€β”€ .github/
β”‚   └── workflows/       # GitHub Actions CI/CD pipelines
β”œβ”€β”€ backend/             # Express server, routes, models, controllers
β”œβ”€β”€ frontend/            # Client-side assets and views
β”œβ”€β”€ package.json
β”œβ”€β”€ package-lock.json
└── README.md

πŸš€ Getting Started

Prerequisites

  • Node.js v18 or higher
  • npm v9 or higher

Installation

# Clone the repository
git clone https://github.com/SreedeepCode/reGive.git
cd reGive

# Install dependencies
npm install

Environment Variables

Create a .env file in the project root and fill in the required values:

PORT=3000
MONGO_URI=your_mongodb_connection_string
SESSION_SECRET=your_session_secret
# Add any other environment variables here

Running Locally

# Start the development server
npm start

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


πŸ“œ License

This project is open source. See the repository for license details.


πŸ‘€ Author

Sreedeep Rajeevan