Skip to content

A community-driven directory showcasing developers, designers, and tech enthusiasts from Katsina. Built with Next.js, Tailwind CSS, and Framer Motion, it provides an elegant UI where contributors can add their details (name, contact info, socials, portfolio links, etc.) directly into a JSON file.

Notifications You must be signed in to change notification settings

Raytme/Katsina-Tech-Directory

 
 

Repository files navigation

Katsina Tech Directory

A comprehensive, community-driven directory showcasing the vibrant technology ecosystem in Katsina State, Nigeria. This open-source project connects developers, companies, and tech communities to foster collaboration and growth in the region.

🌟 About

The Katsina Tech Directory serves as a central hub for discovering and connecting with:

  • Developers: Talented software engineers, designers, and tech professionals
  • Companies: Innovative startups and established tech businesses
  • Communities: Tech groups, meetups, and organizations fostering learning and collaboration

🚀 Features

  • Responsive Design: Works seamlessly on desktop, tablet, and mobile devices
  • Dark/Light Mode: Toggle between themes for comfortable viewing
  • GitHub Integration: Real-time repository statistics and contributor information
  • Animated UI: Smooth animations powered by Framer Motion
  • Community-Driven: Easy contribution process through GitHub pull requests

🛠️ Tech Stack

  • Framework: Next.js 14 (App Router)
  • Styling: Tailwind CSS
  • Animations: Framer Motion
  • Theme: next-themes for dark/light mode
  • Icons: Lucide React
  • Deployment: Vercel

🏃‍♂️ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository: ```bash git clone https://github.com/Katsina-Open-Source/Katsina-Tech-Directory.git cd directory ```

  2. Install dependencies: ```bash npm install ```

  3. Run the development server: ```bash npm run dev ```

  4. Open http://localhost:3000 in your browser.

📁 Project Structure

``` ├── app/ # Next.js app directory │ ├── developers/ # Developers listing page │ ├── companies/ # Companies listing page │ ├── communities/ # Communities listing page │ └── page.tsx # Homepage ├── components/ # Reusable React components │ ├── cards/ # Card components for each entity type │ ├── ui/ # shadcn/ui components │ └── navbar.tsx # Navigation component ├── data/ # JSON data files │ ├── developers.json # Developer profiles │ ├── companies.json # Company information │ └── communities.json # Community details └── types/ # TypeScript type definitions ```

🤝 Contributing

We welcome contributions from everyone! Whether you're a developer, company, or community in Katsina State, you can add yourself to our directory. See our Contributing Guide for detailed instructions.

Quick Contribution Steps

  1. Fork this repository
  2. Edit the appropriate JSON file in the /data folder
  3. Add your information following the existing format
  4. Submit a pull request

📊 Current Statistics

  • Developers: Check the live count on our website
  • Companies: Growing list of innovative businesses
  • Communities: Active tech groups and meetups

🌍 Community

Join our growing community:

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

  • All contributors who have added their profiles to the directory
  • The Katsina tech community for their support and feedback
  • Open source projects that made this possible

Made with ❤️ by the Katsina Tech Community

Help us grow this directory by adding your profile and sharing it with others in the Katsina tech ecosystem!

About

A community-driven directory showcasing developers, designers, and tech enthusiasts from Katsina. Built with Next.js, Tailwind CSS, and Framer Motion, it provides an elegant UI where contributors can add their details (name, contact info, socials, portfolio links, etc.) directly into a JSON file.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 95.6%
  • CSS 4.2%
  • JavaScript 0.2%