Skip to content

Repository files navigation

🌟 Open Source Contributor Directory

A modern, interactive directory showcasing open-source contributors and community members. Built with Next.js 14, React, TypeScript, and Tailwind CSS.

This project serves as both a community showcase and a hands-on workshop repository for first-time open-source contributors to practice submitting Pull Requests (PRs), debugging code, and adding custom profile cards.


✨ Features

  • 🎴 Contributor Cards: View contributor bios, skills, GitHub avatars, and social links.
  • 🔍 Interactive Search & Filtering: Filter contributors in real-time by name, skill, or role.
  • 📊 Community Stats: Dynamic count of active contributors, total skills represented, and contributions.
  • 🎨 Modern Dark UI: Designed with Tailwind CSS, micro-interactions, and glassmorphism styling.
  • 🚀 Workshop Ready: Includes step-by-step contribution tasks and exercise issues for PR practice.

🛠️ Tech Stack


🚀 Getting Started

Prerequisites

Make sure you have Node.js (v18.x or higher) and npm installed.

Installation

  1. Clone the repository:

    git clone https://github.com/OpenSource-UIT/Open-Source-Contributor-Directory.git
    cd Open-Source-Contributor-Directory
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm run dev
  4. Open http://localhost:3000 in your browser to view the application.


🤝 How to Contribute

We welcome all contributions! Whether you want to add your own profile card or tackle one of the workshop exercises:

  1. Read our CONTRIBUTING.md for detailed instructions.
  2. Add your entry to src/data/contributors.json.
  3. Create a feature branch and submit a Pull Request!

About

The Open Source Contributor Directory is an interactive showcase platform built with Next.js 14, TypeScript, and Tailwind CSS. It highlights community contributors while providing a structured, beginner-friendly environment for developers to practice submitting pull requests, handling feature branches, and adding custom profile cards.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages