๐Ÿš€ CodeHub

A modern, beautiful, and feature-rich code repository platform built with Next.js, TypeScript, and Tailwind CSS. Discover, share, and collaborate on code repositories with an elegant UI and powerful features.


โœจ Features

  • ๐Ÿ” Explore Repositories: Browse and search through a curated list of repositories with rich metadata.
  • ๐Ÿ—‚๏ธ File Tree & Code Viewer: Navigate project files and view code with syntax highlighting.
  • ๐Ÿ“Š Repository Stats: See stars, forks, contributors, and more at a glance.
  • ๐Ÿท๏ธ Tags & Badges: Visual indicators for language, privacy, and repository status.
  • ๐Ÿง‘โ€๐Ÿ’ป Issues & Pull Requests: Track issues and pull requests in a clean, tabbed interface.
  • ๐ŸŒ— Dark/Light Theme: Seamless theme switching with system preference support.
  • ๐Ÿงฉ Reusable UI Components: Built with a robust design system using Radix UI and custom Tailwind components.
  • โšก Blazing Fast: Optimized for performance and static export (SSG).

๐Ÿ› ๏ธ Tech Stack


๐Ÿ“ฆ Folder Structure

CodeHub/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/           # Next.js app directory (routing, pages)
โ”‚   โ”œโ”€โ”€ components/    # Reusable UI and layout components
โ”‚   โ”œโ”€โ”€ hooks/         # Custom React hooks
โ”‚   โ”œโ”€โ”€ lib/           # Mock data and utilities
โ”‚   โ””โ”€โ”€ ...
โ”œโ”€โ”€ public/            # Static assets
โ”œโ”€โ”€ styles/            # Global styles (Tailwind)
โ”œโ”€โ”€ package.json       # Project metadata and scripts
โ”œโ”€โ”€ tailwind.config.ts # Tailwind CSS config
โ””โ”€โ”€ ...

๐Ÿšฆ Getting Started

1. Clone the repository

git clone https://github.com/your-username/codehub.git
cd codehub

2. Install dependencies

npm install

3. Run the development server

npm run dev

Visit http://localhost:3000 to view the app.

4. Build for production

npm run build
npm start

๐ŸŒˆ UI Highlights

  • Modern Dashboard: Responsive, accessible, and visually appealing.
  • Tabs, Cards, Badges: Built with Radix UI and custom Tailwind components.
  • Dark Mode: Automatic and manual theme switching.
  • File Tree & Code Viewer: Intuitive navigation and code display.

๐Ÿงช Mock Data

The app uses mock data for repositories, file trees, and code content. You can customize these in src/lib/mock-data.ts for demos or prototyping.


๐Ÿš€ Deployment

This project is ready for deployment on Vercel and supports static export (output: export).


๐Ÿค Contributing

Contributions are welcome! Please open issues or pull requests for new features, bug fixes, or improvements.

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'Add some feature')
  4. Push to the branch (git push origin feature/your-feature)
  5. Open a pull request

๐Ÿ“„ License

This project is licensed under the MIT License.


๐Ÿ™ Acknowledgements


Made with โค๏ธ by the CodeHub Team