https://github.com/salmanfxrsi/causebridge-backend
Backend for the CauseBridge platform, built with Node.js and Express. It handles user authentication, CRUD operations for volunteer posts, and MongoDB data storage. Uses JWT for secure routes and environment variables for sensitive data management. Provides a RESTful API with CORS support.
https://github.com/salmanfxrsi/causebridge-backend
api-development api-security backend cors crud-operations environment-variables express firebase jwt-authentication mongodb mongodb-atlas node-api nodejs rest-api user-authentication volunteer-management
Last synced: about 2 months ago
JSON representation
Backend for the CauseBridge platform, built with Node.js and Express. It handles user authentication, CRUD operations for volunteer posts, and MongoDB data storage. Uses JWT for secure routes and environment variables for sensitive data management. Provides a RESTful API with CORS support.
- Host: GitHub
- URL: https://github.com/salmanfxrsi/causebridge-backend
- Owner: salmanfxrsi
- Created: 2024-12-28T11:45:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-10T16:20:08.000Z (over 1 year ago)
- Last Synced: 2025-06-04T14:19:27.947Z (about 1 year ago)
- Topics: api-development, api-security, backend, cors, crud-operations, environment-variables, express, firebase, jwt-authentication, mongodb, mongodb-atlas, node-api, nodejs, rest-api, user-authentication, volunteer-management
- Language: JavaScript
- Homepage: https://cause-bridge-server-side.vercel.app/
- Size: 18.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CauseBridge - Server Side
CauseBridge is a volunteer management platform designed to streamline the creation and management of volunteer opportunities. This repository contains the server-side logic and API endpoints for the platform.
## Purpose
The server-side application provides the backend support for the CauseBridge platform, including database interactions, authentication, and API endpoints for managing volunteer posts and user actions.
## Frontend Repository
[Visit CauseBridge Frontend Repository](https://github.com/salmanfxrsi/causebridge-frontend)
## Live Server URL
[Deployed Server URL](https://cause-bridge-server-side.vercel.app/)
## Key Features
- **User Authentication**:
- Email/password-based authentication.
- JWT-based private route protection.
- **Volunteer Post Management**:
- Create, read, update, and delete volunteer posts.
- Search functionality for volunteer posts.
- **Volunteer Requests**:
- Handle user requests to join volunteer opportunities.
- Automatically decrement available slots for volunteers.
- **Secure Configuration**:
- Firebase and MongoDB credentials secured with environment variables.
- **Dynamic Data Handling**:
- Pagination and sorting of volunteer posts.
- Status updates for volunteer requests.
## Technology Stack
- **Runtime Environment**: Node.js
- **Framework**: Express.js
- **Database**: MongoDB (Mongoose for ORM)
- **Authentication**: Firebase Auth, JSON Web Token (JWT)
- **Environment Management**: dotenv
- **Deployment**: Vercel
## API Endpoints
### Authentication
- **POST** `/api/auth/register` - Register a new user.
- **POST** `/api/auth/login` - Log in a user and return a JWT.
### Volunteer Posts
- **GET** `/api/posts` - Retrieve all volunteer posts (supports pagination and sorting).
- **GET** `/api/posts/:id` - Retrieve a specific volunteer post.
- **POST** `/api/posts` - Create a new volunteer post (protected route).
- **PUT** `/api/posts/:id` - Update a volunteer post (protected route).
- **DELETE** `/api/posts/:id` - Delete a volunteer post (protected route).
### Volunteer Requests
- **POST** `/api/requests` - Submit a new volunteer request.
- **GET** `/api/requests` - Retrieve user-specific volunteer requests.
- **DELETE** `/api/requests/:id` - Cancel a volunteer request.
## Environment Variables
Ensure you have a `.env` file in the root directory with the following keys:
```env
PORT=5000
MONGO_URI=your-mongodb-connection-string
JWT_SECRET=your-jwt-secret
FIREBASE_API_KEY=your-firebase-api-key
FIREBASE_AUTH_DOMAIN=your-firebase-auth-domain
```
## NPM Packages Used
- **express**: Web framework for building APIs.
- **mongoose**: MongoDB object modeling for Node.js.
- **jsonwebtoken**: Implementation of JWT for secure authentication.
- **dotenv**: Loads environment variables from `.env` file.
- **cors**: Middleware for enabling CORS.
- **bcryptjs**: For hashing passwords securely.
- **firebase-admin**: Firebase integration for authentication.
## Contact
For any queries or support, feel free to contact the developer at [salmanxprivate@gmail.com].
---
Thank you for watching **CauseBridge Server Side Repository**!