Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ about: Create a report to help us improve DevPath India
title: '[BUG] '
labels: bug
assignees: ''

---

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
Expand All @@ -24,14 +24,16 @@ A clear and concise description of what you expected to happen.
If applicable, add screenshots to help explain your problem.

**Desktop (please complete the following information):**
- OS: [e.g. Windows, Mac, Linux]
- Browser: [e.g. Chrome, Safari, Firefox]
- Version: [e.g. 22]

- OS: [e.g. Windows, Mac, Linux]
- Browser: [e.g. Chrome, Safari, Firefox]
- Version: [e.g. 22]

**Smartphone (please complete the following information):**
- Device: [e.g. iPhone 13, Pixel 6]
- OS: [e.g. iOS 15, Android 13]
- Browser: [e.g. Safari, Chrome]

- Device: [e.g. iPhone 13, Pixel 6]
- OS: [e.g. iOS 15, Android 13]
- Browser: [e.g. Safari, Chrome]

**Additional context**
Add any other context about the problem here.
1 change: 0 additions & 1 deletion .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ about: Suggest an idea for DevPath India
title: '[FEATURE] '
labels: enhancement
assignees: ''

---

**Is your feature request related to a problem? Please describe.**
Expand Down
6 changes: 6 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,27 @@
## Description

<!-- Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. -->

Fixes # (issue)

## Type of change

<!-- Please delete options that are not relevant. -->

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] This change requires a documentation update

## How Has This Been Tested?

<!-- Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. -->

- [ ] Local testing
- [ ] Vercel Preview Deployment

## Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/gitleaks.yml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
name: Gitleaks
on:
push:
branches: [ "master", "main" ]
branches: ['master', 'main']
pull_request:
branches: [ "master", "main" ]
branches: ['master', 'main']

jobs:
scan:
Expand Down
12 changes: 6 additions & 6 deletions .github/workflows/label-migrator.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,24 +20,24 @@ jobs:
console.log("No PR body found");
return;
}

// Regex to find linked issues like "Fixes #123", "Resolves #123", "Closes #123"
const issueRegex = /(?:fix(?:e[sd])?|resolve[sd]?|close[sd]?)\s+#(\d+)/gi;
let match;
const issueNumbers = [];
while ((match = issueRegex.exec(prBody)) !== null) {
issueNumbers.push(parseInt(match[1]));
}

if (issueNumbers.length === 0) {
console.log("No linked issues found in PR body");
return;
}

console.log(`Found linked issues: ${issueNumbers.join(", ")}`);

const labelsToAdd = new Set();

for (const issueNumber of issueNumbers) {
try {
const issue = await github.rest.issues.get({
Expand All @@ -53,7 +53,7 @@ jobs:
console.log(`Could not fetch issue #${issueNumber}: ${error.message}`);
}
}

if (labelsToAdd.size > 0) {
console.log(`Adding labels: ${Array.from(labelsToAdd).join(", ")}`);
await github.rest.issues.addLabels({
Expand Down
20 changes: 10 additions & 10 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
Examples of behavior that contributes to a positive environment for our
community include:

* Demonstrating empathy and kindness toward other people
* Being respectful of differing opinions, viewpoints, and experiences
* Giving and gracefully accepting constructive feedback
* Accepting responsibility and apologizing to those affected by our mistakes,
- Demonstrating empathy and kindness toward other people
- Being respectful of differing opinions, viewpoints, and experiences
- Giving and gracefully accepting constructive feedback
- Accepting responsibility and apologizing to those affected by our mistakes,
and learning from the experience
* Focusing on what is best not just for us as individuals, but for the
- Focusing on what is best not just for us as individuals, but for the
overall community

Examples of unacceptable behavior include:

* The use of sexualized language or imagery, and sexual attention or
- The use of sexualized language or imagery, and sexual attention or
advances of any kind
* Trolling, insulting or derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information, such as a physical or email
- Trolling, insulting or derogatory comments, and personal or political attacks
- Public or private harassment
- Publishing others' private information, such as a physical or email
address, without their explicit permission
* Other conduct which could reasonably be considered inappropriate in a
- Other conduct which could reasonably be considered inappropriate in a
professional setting

## Enforcement Responsibilities
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -307,4 +307,4 @@ If you are contributing as part of GSSoC, please follow these guidelines:

## Final Notes

Thank you for contributing to DevPath Web. Your time, effort, and ideas help make this project better for the whole community.
Thank you for contributing to DevPath Web. Your time, effort, and ideas help make this project better for the whole community.
5 changes: 4 additions & 1 deletion GIT_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ If you're making your first contribution, follow the steps carefully.
Forking creates a copy of the repository under your GitHub account.

### Steps

1. Open the original repository.
2. Click the **Fork** button on the top-right corner.
3. GitHub will create a copy in your account.
Expand Down Expand Up @@ -106,6 +107,7 @@ git checkout -b bug/login-error-fix
# 6. Make Your Changes

Now you can:

- Add new files
- Modify existing files
- Fix bugs
Expand Down Expand Up @@ -257,9 +259,10 @@ Replace `3` with the number of commits you want to combine.
# 15. Need Help?

If you get stuck:

- Read the project documentation
- Ask maintainers politely
- Search GitHub Discussions or Issues
- Learn gradually — everyone starts somewhere 🚀

Happy Contributing! 🎉
Happy Contributing! 🎉
94 changes: 46 additions & 48 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,12 @@
| Section | Description |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [🚀 Features](#-features) | Explore the platform's core functionality and community-focused features. |
| [🛠️ Tech Stack](#️-tech-stack) | Discover the technologies, frameworks, and services powering the platform. |
| [🛠️ Tech Stack](#️-tech-stack) | Discover the technologies, frameworks, and services powering the platform. |
| [📂 Project Structure](#-project-structure) | Understand the organization and architecture of the codebase. |
| [📸 Screenshots](#-screenshots) | Preview key pages and user experiences. |
| [🏁 Getting Started](#-getting-started) | Set up and run the project locally. |
| [📋 Prerequisites](#-prerequisites) | Review required tools and dependencies. |
| [⚡ Installation](#-installation) | Follow the project installation steps. |
| [⚡ Installation](#-installation) | Follow the project installation steps. |
| [🔥 Local Firebase Configuration](#-local-firebase-configuration) | Configure Firebase for local development. |
| [📜 Available Scripts](#-available-scripts) | Reference commonly used development commands. |
| [🤝 Contributing](#-contributing) | Learn how to contribute to the project. |
Expand All @@ -45,13 +45,13 @@

## 🚀 Features

* 🤝 **Community Hub** — Connect with developers, mentors, and contributors.
* 📅 **Event Management** — Discover hackathons, workshops, and community events.
* 📚 **Resource Library** — Access curated roadmaps, tutorials, and learning resources.
* 📖 **Wiki & Knowledge Base** — Explore guides, documentation, and community articles.
* 👤 **User Profiles** — Showcase your skills, achievements, and contributions.
* 🌟 **Open Source Collaboration** — Contribute to projects and grow through real-world experience.
* 📱 **Responsive Design** — Seamlessly accessible across desktop, tablet, and mobile devices.
- 🤝 **Community Hub** — Connect with developers, mentors, and contributors.
- 📅 **Event Management** — Discover hackathons, workshops, and community events.
- 📚 **Resource Library** — Access curated roadmaps, tutorials, and learning resources.
- 📖 **Wiki & Knowledge Base** — Explore guides, documentation, and community articles.
- 👤 **User Profiles** — Showcase your skills, achievements, and contributions.
- 🌟 **Open Source Collaboration** — Contribute to projects and grow through real-world experience.
- 📱 **Responsive Design** — Seamlessly accessible across desktop, tablet, and mobile devices.

---

Expand All @@ -63,43 +63,42 @@ DevPath India is built using a modern, scalable, and developer-friendly technolo

<div align="center">

| Category | Technology |
|----------|------------|
| **Framework** | Next.js 16 (App Router) |
| **Frontend Library** | React 19 |
| **Language** | TypeScript |
| **Styling** | Tailwind CSS |
| **Animations** | Framer Motion & GSAP |
| **Icons** | Lucide React |
| **Linting & Code Quality** | ESLint |
| **Package Manager** | npm |
| **Backend Services** | Firebase |
| **Deployment** | Vercel |
| Category | Technology |
| -------------------------- | ----------------------- |
| **Framework** | Next.js 16 (App Router) |
| **Frontend Library** | React 19 |
| **Language** | TypeScript |
| **Styling** | Tailwind CSS |
| **Animations** | Framer Motion & GSAP |
| **Icons** | Lucide React |
| **Linting & Code Quality** | ESLint |
| **Package Manager** | npm |
| **Backend Services** | Firebase |
| **Deployment** | Vercel |

</div>


---

### Architecture Overview

```mermaid
flowchart LR
User["👤 User"]

User --> UI["⚛️ React 19 UI"]

UI --> Next["▲ Next.js 16"]

Next --> TS["📘 TypeScript"]
Next --> Tailwind["🎨 Tailwind CSS"]
Next --> Motion["✨ Framer Motion / GSAP"]

Next --> Firebase["🔥 Firebase"]

Firebase --> Auth["🔐 Authentication"]
Firebase --> DB["📂 Database"]

Next --> Vercel["☁️ Vercel Deployment"]
```

Expand Down Expand Up @@ -136,11 +135,10 @@ DevPath-Web/
└── eslint.config.mjs # ESLint rules and configuration
```


## 📸 Screenshots

| Home Page | Community |
| :---: | :---: |
| Home Page | Community |
| :-------------------------------------------------------------------: | :------------------------------------------------------------------------: |
| <img src="public/screenshot-home.webp" alt="Home Page" height="250"/> | <img src="public/screenshot-community.webp" alt="Community" height="250"/> |

---
Expand Down Expand Up @@ -181,10 +179,10 @@ Get DevPath India running locally in just a few steps.

Make sure you have:

* Node.js (Latest LTS recommended)
* npm, yarn, or pnpm
* Git
* A Firebase project
- Node.js (Latest LTS recommended)
- npm, yarn, or pnpm
- Git
- A Firebase project

---

Expand Down Expand Up @@ -217,9 +215,9 @@ Add your Firebase credentials to `.env.local`.

1. Create a project in the Firebase Console.
2. Enable:
- Authentication
- Firestore Database

* Authentication
* Firestore Database
3. Register a Web App and copy the Firebase configuration.
4. Paste the values into `.env.local`.

Expand Down Expand Up @@ -301,9 +299,9 @@ Contributions of all sizes are welcome! Whether you're fixing bugs, improving do

Before contributing, please review our:

* 📖 [Contributing Guidelines](CONTRIBUTING.md)
* 🐛 [Open Issues](https://github.com/devpathindcommunity-india/DevPath-Web/issues)
* 🌱 [Good First Issues](https://github.com/devpathindcommunity-india/DevPath-Web/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
- 📖 [Contributing Guidelines](CONTRIBUTING.md)
- 🐛 [Open Issues](https://github.com/devpathindcommunity-india/DevPath-Web/issues)
- 🌱 [Good First Issues](https://github.com/devpathindcommunity-india/DevPath-Web/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)

We appreciate every contribution, from first-time contributors to experienced maintainers.

Expand All @@ -315,7 +313,7 @@ DevPath India is committed to fostering a welcoming, inclusive, and respectful c

By participating in this project, you agree to follow our:

* 📜 [Code of Conduct](CODE_OF_CONDUCT.md)
- 📜 [Code of Conduct](CODE_OF_CONDUCT.md)

Let's build a positive and collaborative environment together.

Expand All @@ -327,15 +325,15 @@ This project is distributed under the **DevPath India Source-Available License**

### What You Can Do

* ✅ Clone and run the project locally
* ✅ Learn from and modify the source code
* ✅ Submit pull requests and community contributions
- ✅ Clone and run the project locally
- ✅ Learn from and modify the source code
- ✅ Submit pull requests and community contributions

### Restrictions

* ❌ Commercial use is prohibited
* ❌ Hosting public clones or competing services is not permitted
* ❌ Redistribution under the DevPath India brand is not allowed
- ❌ Commercial use is prohibited
- ❌ Hosting public clones or competing services is not permitted
- ❌ Redistribution under the DevPath India brand is not allowed

> [!WARNING]
> The **DevPath India** name, logo, branding assets, and visual identity are protected and may not be used without explicit permission.
Expand All @@ -344,10 +342,10 @@ For complete terms, please refer to the [LICENSE](LICENSE) file.

---


## 🌟 Major Contributors

- **Aditya948351** - Core Maintainer & Lead Developer

---

<p align="center">
Expand Down
Loading
Loading