Connecto - SDG Collaboration Platform

Connecting organizations worldwide to collaborate on UN Sustainable Development Goals

🌍 Overview

Connecto is a full-stack web platform that facilitates collaboration between organizations, NGOs, educational institutions, and government bodies working toward the UN's 17 Sustainable Development Goals (SDGs). The platform enables resource sharing, project management, partnership building, and impact tracking.

✨ Key Features

• 🔐 Secure Authentication - Google OAuth & JWT-based auth with refresh tokens
• 🏢 Organization Management - Create and manage verified organization profiles
• 📊 Project Tracking - Manage SDG-aligned projects with milestones
• 🤝 Resource Exchange - Match resource requests with offers (funding, volunteers, materials, expertise)
• 💬 Real-time Messaging - Socket.io powered communication
• 📈 Analytics Dashboard - Track contributions and SDG progress
• 👥 Partnership Discovery - Find and connect with complementary organizations
• 🎨 Modern UI - Responsive design with Framer Motion animations

🛠️ Tech Stack

Frontend

• React 19.2.0 + Vite 7.2.4
• Tailwind CSS + shadcn/ui
• Framer Motion
• React Router DOM
• Axios + React Hook Form + Zod

Backend

• Node.js + Express 5.2.1
• MongoDB + Mongoose 9.0.0
• Socket.io 4.8.1
• Passport.js (Google OAuth)
• JWT Authentication
• Cloudinary (file uploads)

📁 Project Structure

Connecto/
├── client/                 # React frontend
│   ├── src/
│   │   ├── api/           # API service layer
│   │   ├── components/    # Reusable components
│   │   ├── context/       # React Context
│   │   ├── pages/         # Page components
│   │   └── lib/           # Utilities
│   └── .env.example       # Environment template
│
├── server/                # Express backend
│   ├── src/
│   │   ├── config/        # Configuration
│   │   ├── controllers/   # Request handlers
│   │   ├── middlewares/   # Express middleware
│   │   ├── models/        # Mongoose models
│   │   ├── routes/        # API routes
│   │   └── services/      # Business logic
│   └── .env.example       # Environment template
│
└── Documentation/         # Guides and docs

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• MongoDB (local or Atlas)
• Google OAuth credentials
• Cloudinary account (for file uploads)

Installation

1. Clone the repository

git clone https://github.com/lakshmanbhukya/connecto.git
cd connecto

2. Set up the server

cd server
npm install
cp .env.example .env
# Edit .env with your credentials
npm run dev

3. Set up the client

cd client
npm install
cp .env.example .env
# Edit .env with API URL
npm run dev

4. Access the application

• Frontend: http://localhost:5173
• Backend: http://localhost:5000

🔧 Configuration

Environment Variables

Client (.env)

VITE_API_URL=http://localhost:5000

Server (.env)

PORT=5000
NODE_ENV=development
MONGO_URI=mongodb://localhost:27017/connecto
JWT_SECRET=your_jwt_secret_min_32_chars
JWT_REFRESH_SECRET=your_refresh_secret_min_32_chars
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:5000/api/auth/google/callback
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USER=your_smtp_user
SMTP_PASS=your_smtp_password
EMAIL_FROM=Connecto <noreply@yourdomain.com>
CLIENT_URL=http://localhost:5173

See .env.example files for complete configuration.

🧪 Testing

Integration Tests

# Make sure server is running
cd server
npm run dev

# Run integration tests
cd ..
node test-integration.js

E2E Tests (Playwright)

cd client
npx playwright test

📚 Documentation

• Deployment Guide - Complete deployment instructions
• Production Checklist - Pre-deployment checklist
• Integration Test Plan - Testing scenarios
• API Documentation - API endpoints reference

🔒 Security

• JWT tokens stored in httpOnly cookies
• Password hashing with bcryptjs
• Input validation with express-validator
• Rate limiting on API endpoints
• CORS configuration
• Helmet security headers
• XSS and SQL injection protection

🚢 Deployment

Quick Deploy Options

Vercel (Frontend) + Render (Backend)

# Frontend
vercel --prod

# Backend
git push render main

Railway (Full Stack)

railway up

Docker

docker-compose up -d

See DEPLOYMENT_GUIDE.md for detailed instructions.

📊 API Endpoints

Authentication

• POST /api/auth/register - Register new user
• POST /api/auth/login - Login user
• GET /api/auth/me - Get current user
• POST /api/auth/refresh - Refresh access token
• GET /api/auth/google - Google OAuth

Organizations

• GET /api/orgs - List organizations
• POST /api/orgs - Create organization
• GET /api/orgs/:id - Get organization
• PUT /api/orgs/:id - Update organization

Projects

• GET /api/projects - List projects
• POST /api/projects - Create project
• GET /api/projects/:id - Get project details
• POST /api/projects/:id/milestones - Add milestone

Resources

• GET /api/resources - List resources
• POST /api/resources - Create resource
• POST /api/resources/:id/accept - Accept resource

See full API documentation for complete endpoint list.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• UN Sustainable Development Goals
• shadcn/ui for beautiful components
• All contributors and supporters

---

Made with ❤️ for a sustainable future