DevPath India Community Website

Welcome to the official repository for the DevPath India Community Website. This platform is designed to foster collaboration, share resources, manage events, and connect developers within the DevPath India community. Built with the latest web technologies, it offers a modern, responsive, and interactive user experience.

📑 Table of Contents

• 🚀 Features
• 🛠️ Tech Stack
• 📁 Folder Structure
• 📸 Screenshots
• 🏁 Getting Started
  • Prerequisites
  • Installation
  • 🔥 Local Firebase Configuration
• 📜 Scripts
• 🤝 Contributing
• 💖 Code of Conduct
• 📄 License & Brand Protection
• 🌟 Major Contributors

---

🚀 Features

• Community Hub: Connect with fellow developers, mentors, and team members.
• Event Management: Stay updated with upcoming hackathons, workshops, and meetups.
• Resource Library: Access curated learning paths, tutorials, and documentation.
• Wiki & Knowledge Base: Comprehensive guides and community-contributed articles.
• User Profiles: Showcase your contributions, skills, and community activity.
• Open Source: A platform built by the community, for the community.

🛠️ Tech Stack

This project leverages a modern and powerful technology stack:

• Framework: Next.js 16 (App Router)
• Library: React 19
• Language: TypeScript
• Styling: Tailwind CSS
• Animations: Framer Motion & GSAP
• Icons: Lucide React
• Linting: ESLint

📁 Folder Structure

A quick overview of the project's organization to help new contributors navigate the codebase easily.

DevPath-Web/
├── .github/               # GitHub workflows, PR & issue templates
├── public/                # Static assets (images, icons, fonts, logo)
├── scripts/               # Utility and automation scripts
├── src/                   # Main source code
│   ├── app/               # Next.js App Router — pages, layouts & routing
│   ├── assets/            # Project assets (SVGs, illustrations)
│   ├── components/        # Reusable UI components used across pages
│   ├── config/            # App-level configuration and constants
│   ├── context/           # React Context API providers (global state)
│   ├── data/              # Static data, mock data & content constants
│   ├── hooks/             # Custom React hooks for shared logic
│   ├── lib/               # Third-party library setups (Firebase, etc.)
│   └── utils/             # Helper functions and utility methods
├── .env.example           # Environment variables template
├── .env.local             # Local environment variables (git-ignored)
├── firebase.json          # Firebase Hosting & services configuration
├── firestore.rules        # Firestore security rules
├── firestore.indexes.json # Firestore composite indexes
├── next.config.ts         # Next.js configuration
├── tailwind.config.ts     # Tailwind CSS configuration
├── tsconfig.json          # TypeScript compiler configuration
├── postcss.config.js      # PostCSS configuration
└── eslint.config.mjs      # ESLint rules and configuration

📸 Screenshots

Home Page	Community

🏁 Getting Started

Follow these steps to set up the project locally on your machine.

Prerequisites

Ensure you have the following installed:

• Node.js (Latest LTS version recommended)
• npm, yarn, or pnpm
• Git

Installation

1. Clone the repository:

   git clone https://github.com/devpathindcommunity-india/DevPath-Web.git
   cd DevPath-Web

2. Install dependencies:

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Set up Environment Variables: Copy .env.example to .env.local:

   cp .env.example .env.local

   Open .env.local and fill in your Firebase credentials.

🔥 Local Firebase Configuration

To run this project locally, you'll need your own Firebase project:

1. Create a Firebase Project: Go to the Firebase Console and create a new project.
2. Enable Services:
   • Authentication: Enable Email/Password or Google provider.
   • Firestore: Create a database in test mode (or apply the rules in firestore.rules).
3. Register a Web App: Add a "Web App" to your Firebase project to get your configuration object.
4. Fill .env.local: Copy the values from your Firebase config object into your .env.local file.
5. Install Firebase CLI:

   npm install -g firebase-tools

6. Login & Use Project:

   firebase login
   firebase use --add <your-project-id>

Caution

Security Reminder: Never commit your .env.local file. It contains sensitive keys that should remain private to your local environment.

4. Run the development server:

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev

5. Open your browser: Navigate to http://localhost:3000 to see the application running.

🚀 Firebase Hosting Deployment

To deploy the production-ready site directly to Firebase Hosting:

1. Build the production static export: This compiles the Next.js App Router files into highly optimized static assets inside the out/ directory:

   npm run build

2. Deploy to Firebase: Deploy the build files along with custom Firestore indexes and rules to the live platform:

   npx firebase deploy

📜 Scripts

• npm run dev: Starts the development server.
• npm run build: Builds the application for production.
• npm run start: Starts the production server.
• npm run lint: Runs ESLint to check for code quality issues.

🤝 Contributing

We welcome contributions from the community! Please read our Contributing Guidelines for details on how to get started. Don't forget to check our good first issues if you're looking for a place to start!

💖 Code of Conduct

We are committed to providing a friendly, safe, and welcoming environment for all. Please read and follow our Code of Conduct.

📄 License & Brand Protection

This project is licensed under a custom DevPath India Source-Available License. See the LICENSE file for full details.

Warning

Important Licensing Terms:

• You may clone, run, and modify this code locally to learn or submit contributions.
• You may NOT use this software for commercial purposes or host it publicly as a competing platform/clone.
• The "DevPath India" name, logos, and brand identity are strictly copyrighted and trademarked. They cannot be used in derivative works without explicit permission.

---

Built with ❤️ by the DevPath India Community.

🌟 Major Contributors

• Aditya948351 - Core Maintainer & Lead Developer