🌟 OPENGEEK – India's Premier Tech Community 🚀

Empowering student developers through real-world projects, mentorship, and community collaboration

🌐 Visit Website • 💬 Join Discord • 📱 Follow Instagram • 🚀 Get Started

OpenGeek is India's fastest-growing tech community for student developers, built by students, for students. We bridge the gap between academic learning and industry experience through:

• 🚀 Real-world projects with actual impact
• 👥 Peer-to-peer mentorship and collaboration
• 💼 Internship and job opportunities
• 🏆 Hackathons and coding competitions
• 📚 Skill development workshops and bootcamps
• 🌐 Open source contributions and portfolio building

This monorepo contains all apps, platforms, and tools under the OpenGeek initiative.

OPENGEEK/
│
├── admin/                     # 🔧 Admin dashboard (React + Vite)
│   ├── client/                # Admin frontend (React + TypeScript + Vite)
│   │   ├── src/               # Admin app source code
│   │   ├── public/            # Static assets
│   │   ├── components.json    # UI/component library config
│   │   ├── vite.config.ts     # Vite configuration
│   │   ├── tsconfig.json      # TypeScript configuration
│   │   └── package.json       # Frontend dependencies
│   │
│   └── server/                # Admin backend (Express.js)
│       ├── index.js           # Admin API entry point
│       └── package.json       # Backend dependencies
│
├── communitysite/             # ✅ Main fullstack app (Client + Server)
│   ├── client/                # Frontend (Next.js + Tailwind + TypeScript)
│   │   ├── src/               # Main app source code (components, pages, utils)
│   │   ├── public/            # Static assets (favicon, logos, images)
│   │   ├── .next/             # Next.js build output
│   │   ├── components.json    # UI/component library config
│   │   ├── eslint.config.mjs  # ESLint configuration
│   │   ├── next.config.ts     # Next.js configuration
│   │   ├── tsconfig.json      # TypeScript configuration
│   │   ├── .env*              # Environment variables
│   │   └── package.json       # Frontend dependencies
│   │
│   ├── server/                # Backend (Express.js + PostgreSQL)
│   │   ├── config/            # Database and app configuration
│   │   ├── database-scripts/  # Database setup and migration scripts
│   │   ├── middleware/        # Express middleware (auth, validation, etc.)
│   │   ├── routes/            # API route handlers
│   │   ├── utils/             # Utility functions
│   │   ├── index.js           # API entry point (Express app)
│   │   ├── .env*              # Server environment variables
│   │   ├── render.yaml        # Render deployment config
│   │   └── package.json       # Backend dependencies
│   │
│   ├── CLOUDINARY_INTEGRATION_GUIDE.md
│   ├── SYSTEM_ARCHITECTURE_DOCUMENTATION.txt
│   └── README.md
│
├── enterprise/                # 🏢 Enterprise platform (Next.js)
│   ├── src/                   # Enterprise app source code
│   │   ├── app/               # Next.js App Router pages
│   │   └── components/        # React components
│   ├── public/                # Static assets
│   ├── .next/                 # Next.js build output
│   ├── next.config.ts         # Next.js configuration
│   ├── tailwind.config.js     # Tailwind CSS configuration
│   ├── tsconfig.json          # TypeScript configuration
│   └── package.json           # Dependencies
│
├── mainsite/                  # 🌐 Marketing/landing site for opengeek.in
│   ├── src/                   # Next.js source code
│   │   ├── app/               # Next.js App Router pages
│   │   ├── components/        # React components
│   │   ├── lib/               # Utility libraries
│   │   └── middleware.ts      # Next.js middleware
│   ├── public/                # Static assets (images, icons, etc.)
│   ├── next.config.ts         # Next.js configuration
│   ├── tailwind.config.js     # Tailwind CSS configuration
│   ├── tsconfig.json          # TypeScript configuration
│   ├── vercel.json            # Vercel deployment config
│   └── package.json           # Dependencies
│
├── .vscode/                   # VS Code workspace settings
├── LICENSE
└── README.md                  # Project overview and setup guide

• ESLint - Code linting and quality checks
• Prettier - Code formatting
• Husky - Git hooks for code quality
• VS Code - Recommended IDE with workspace settings

Before you begin, ensure you have the following installed:

git clone https://github.com/AhqafCoder/OPENGEEK.git
cd OPENGEEK

cd communitysite/client
npm install

Create your environment file:

cp .env.example .env.local

Configure your .env.local:

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key

# API Configuration
NEXT_PUBLIC_API_URL=http://localhost:5000/api

# App Configuration
NEXT_PUBLIC_APP_URL=http://localhost:3000

cd ../server
npm install

Create your environment file:

cp .env.example .env

Configure your .env:

# Server Configuration
PORT=5000
NODE_ENV=development

# Database Configuration
DATABASE_URL=postgresql://username:password@localhost:5432/opengeek_community

# Clerk Configuration
CLERK_SECRET_KEY=your_clerk_secret_key
CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key

# Cloudinary Configuration (for image uploads)
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

# Frontend URL (for CORS)
FRONTEND_URL=http://localhost:3000

# Create PostgreSQL database
createdb opengeek_community

# Run database migrations (if available)
npm run migrate

cd communitysite/server
npm run dev

cd communitysite/client
npm run dev

cd mainsite
npm install
npm run dev

cd enterprise
npm install
npm run dev

# Frontend
cd admin/client
npm install
npm run dev

# Backend
cd admin/server
npm install
npm start

• 👤 User Profiles - Customizable profiles with skills, projects, and achievements
• 📝 Social Posts - Share updates, ask questions, and engage with the community
• 🚀 Project Showcase - Display your projects with live demos and GitHub integration
• 💬 Real-time Chat - Connect with fellow developers instantly
• 🏆 Achievement System - Earn badges and recognition for contributions
• � Rkesource Sharing - Access curated learning materials and tutorials
• 🎯 Skill Tracking - Monitor your learning progress and set goals
• 🔍 Smart Search - Find projects, users, and resources easily

• 📱 Responsive Design - Perfect experience across all devices
• ⚡ Fast Loading - Optimized for performance with Next.js
• 🎨 Modern UI - Clean, professional design with smooth animations
• � Analdytics Integration - Track visitor engagement and conversions
• 🔍 SEO Optimized - Built for search engine visibility

• 👥 Team Management - Organize and manage development teams
• 📈 Project Analytics - Track project progress and team performance
• 🔐 Advanced Security - Enterprise-grade security and compliance
• 🔗 API Integration - Connect with existing enterprise tools
• 📊 Custom Dashboards - Tailored insights for business needs

cd communitysite/client
npm run build
# Deploy to Vercel
vercel --prod

cd mainsite
npm run build
# Deploy to Vercel
vercel --prod

1. Connect your GitHub repository to Render
2. Set environment variables in Render dashboard
3. Deploy with automatic builds on push

# Install Railway CLI
npm install -g @railway/cli

# Login and deploy
railway login
railway link
railway up

1. Create a PostgreSQL service on Render
2. Copy the connection string
3. Update your environment variables

1. Create a project on Supabase
2. Get your connection string
3. Run migrations if needed

• Use TypeScript for all new code
• Follow ESLint and Prettier configurations
• Write meaningful commit messages
• Add JSDoc comments for functions
• Use semantic HTML and accessible components

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run E2E tests
npm run test:e2e

# Lint code
npm run lint

# Fix linting issues
npm run lint:fix

# Format code
npm run format

# Type check
npm run type-check

# Check PostgreSQL is running
pg_isready

# Reset database
dropdb opengeek_community
createdb opengeek_community

# Kill process on port 3000
npx kill-port 3000

# Kill process on port 5000
npx kill-port 5000

1. Verify your Clerk keys in environment files
2. Check if you're using the correct environment (dev/prod)
3. Ensure your domain is added to Clerk dashboard

# Clear Next.js cache
rm -rf .next

# Clear node_modules and reinstall
rm -rf node_modules package-lock.json
npm install

If you encounter issues:

1. Check the Issues - Someone might have faced the same problem
2. Join our Discord - Get real-time help from the community
3. Create a new issue - Provide detailed information about your problem

We welcome contributions from developers of all skill levels! Here's how you can contribute:

1. 🍴 Fork the repository
2. 🌿 Create a feature branch

   git checkout -b feature/amazing-feature

3. 💻 Make your changes
4. ✅ Test your changes

   npm test
   npm run lint

5. 📝 Commit your changes

   git commit -m "Add amazing feature"

6. 🚀 Push to your branch

   git push origin feature/amazing-feature

7. 🔄 Open a Pull Request

• Follow the code style - Use ESLint and Prettier
• Write tests - Add tests for new features
• Update documentation - Keep docs up to date
• Be respectful - Follow our code of conduct
• Start small - Begin with small contributions

• 🌐 Website: www.opengeek.in
• 💬 Discord: Join our Discord - Real-time chat and support
• 📱 Instagram: @opengeek.in - Updates and highlights
• 🐦 Twitter: @opengeek_in - News and announcements
• 📧 Email: hello@opengeek.in - Direct contact

• 🚀 Real Projects - Work on projects that matter
• 👥 Mentorship - Learn from experienced developers
• 💼 Opportunities - Access to internships and jobs
• 🏆 Recognition - Get recognized for your contributions
• 📚 Learning - Continuous skill development
• 🤝 Networking - Connect with like-minded developers

Contributors get:

• 🌟 GitHub profile recognition
• 🏅 Community badges and achievements
• 📜 Certificates for significant contributions
• 💼 Job and internship referrals
• 🎤 Speaking opportunities at events

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

• ✅ Commercial use - Use in commercial projects
• ✅ Modification - Modify the code as needed
• ✅ Distribution - Share and distribute freely
• ✅ Private use - Use in private projects
• ❗ Attribution required - Credit the original authors

Special thanks to:

• 🎓 Student Community - For continuous feedback and support
• 👨‍💻 Open Source Contributors - For making this project better
• 🏢 Partner Organizations - For providing opportunities
• 🛠️ Technology Partners - Clerk, Vercel, Render, and others