🚀 Beyond Sight - Event & Volunteer Management System

🏢 Introduction

Samarthanam Trust for Disabled is dedicated to empowering individuals with disabilities through various initiatives. This project is a web-based application built using the MERN stack, designed to streamline event management and volunteer coordination while addressing critical accessibility and management challenges.

🌐 Live Demo : https://beyondsight.vercel.app

Team 17 - Beyond Sight 👥👥

• Abhishek Sharma
• Ayush Tandon
• Garvit Singh
• Kirti Kumari
• Komal Meena
• Prajwal Tiwari

Mentors 🤵

• Sankaran Subramanian LinkedIn

• Kirthan G LinkedIn

Round 1 Presentation

▶ Watch Round 1

Round 2 Presentation

▶ Watch Round 2

Celebrating Our Success: Team 17 Advances to Round 2!

✨ Features

♿ Inclusive by Design

• Fully Accessible Digital Platform – Screen reader compatibility, keyboard navigation, and high-contrast modes for visually impaired users
• Multi-lingual Accessibility – Supports English, Hindi, Kannada for diverse volunteers
• Adaptive Reading Experience – Adjustable font sizes and customizable display settings

📅 Seamless Event Management

• Smart Event Creation – Intuitive templates for different causes (sports, education, rehabilitation)
• Real-Time Task Tracking – Assign volunteers and track progress updates
• Automated Feedback System – Post-event surveys for continuous improvement
• Event Calendar with reminders and notifications

🙌 Volunteer Management

• Dynamic Volunteer Forms – Customizable fields based on event type
• Automated Certificate Generation – E-certificates upon task completion
• Volunteer Analytics Dashboard – Tracks participation trends and engagement metrics
• Performance Insights – Identifies top contributors and improvement areas

🔐 User Authentication & Role Management

• Secure Authentication using Firebase
• Role-based Access Control (Admin, Volunteer, Organizer)

🛠 Tech Stack

• Frontend: React.js, Redux, Tailwind CSS, TypeScript, Vite
• Backend: Node.js, Express.js
• Database: MongoDB
• Authentication: Firebase
• Deployment: Vercel

🚀 Installation & Setup

📌 Prerequisites

Ensure you have the following installed:

• 🟢 Node.js & npm
• 🍃 MongoDB (local or cloud-based like MongoDB Atlas)
• 🔗 Git

📥 Clone the Repositories

Frontend

git clone https://github.com/abhishek-403/code-to-give-frontend
cd code-to-give-frontend

Backend

git clone https://github.com/abhishek-403/code-to-give-backend
cd code-to-give-backend

📦 Install Dependencies

Backend

cd code-to-give-backend
npm install

Frontend

cd code-to-give-frontend
npm install

⚙️ Configure Environment Variables

Create a .env file in both backend and frontend directories and configure required environment variables.

▶️ Run the Application in development mode

Backend

cd code-to-give-backend
npm run dev

Frontend

cd code-to-give-frontend
npm run dev

📡 API Endpoints

Method	Endpoint	Description
🟢 GET	/api/events	Fetch all events
🟠 POST	/api/events	Create a new event
🟢 GET	/api/volunteers	Fetch all volunteers
🟠 POST	/api/volunteers	Register a new volunteer
🔑 POST	/api/auth/login	User login

🖼 Screenshots

⚡ React + TypeScript + Vite Setup

This project uses React with TypeScript and Vite for a fast and modern development experience.

🔧 Expanding ESLint Configuration

For a production-level application, enhance ESLint settings to enable type-aware lint rules:

export default tseslint.config({
  extends: [
    ...tseslint.configs.recommendedTypeChecked,
    ...tseslint.configs.strictTypeChecked,
    ...tseslint.configs.stylisticTypeChecked,
  ],
  languageOptions: {
    parserOptions: {
      project: ['./tsconfig.node.json', './tsconfig.app.json'],
      tsconfigRootDir: import.meta.dirname,
    },
  },
});

Additionally, install and configure React-specific ESLint plugins:

// eslint.config.js
import reactX from 'eslint-plugin-react-x';
import reactDom from 'eslint-plugin-react-dom';

export default tseslint.config({
  plugins: {
    'react-x': reactX,
    'react-dom': reactDom,
  },
  rules: {
    ...reactX.configs['recommended-typescript'].rules,
    ...reactDom.configs.recommended.rules,
  },
});

🤝 Contribution

We welcome contributions from the community. To contribute:

1. 🍴 Fork the repository
2. 🌱 Create a feature branch (git checkout -b feature-xyz)
3. ✏️ Commit your changes (git commit -m 'Add feature xyz')
4. 🚀 Push to your branch (git push origin feature-xyz)
5. 📩 Open a pull request

📞 Contact

For any queries, reach out to us at 📧 [email protected] or visit 🌍 Samarthanam Trust