# Git Galaxy Visualizer

**Git Galaxy Visualizer** is a modern, high-performance 3D visualization platform built with **Next.js**, **TypeScript**, and **Three.js**. It transforms GitHub profiles into interactive celestial systems, where repositories are rendered as dynamic planets based on real-time API data.

This version is the enhanced, framework-based implementation of the original [Git Galaxy](https://github.com/letsconfuse/Git-Galaxy) project.

## Features

- **React-Based Architecture**: Built with Next.js 14 and TypeScript for robust type safety and component modularity.
- **3D Celestial Mapping**: Uses Three.js (WebGL) to represent repositories as planets with size and orbit derived from GitHub stars and forks.
- **Modern UI Components**: Leverages **shadcn/ui** and **Tailwind CSS** for a polished, responsive cyberpunk interface.
- **Real-Time Telemetry**: Interactive data panels providing deep insights into user metrics and language distribution.
- **Optimized Performance**: Smooth 3D rendering with auto-rotation, damping, and efficient state management.

## Tech Stack

- **Framework**: [Next.js](https://nextjs.org/) (App Router)
- **Language**: [TypeScript](https://www.typescriptlang.org/)
- **3D Engine**: [Three.js](https://threejs.org/)
- **Styling**: [Tailwind CSS](https://tailwindcss.com/)
- **UI Components**: [shadcn/ui](https://ui.shadcn.com/)

## Getting Started

### Installation
1. Clone the repository:
   ```bash
   git clone https://github.com/letsconfuse/git-galaxy-visualizer.git
   ```
2. Install dependencies:
   ```bash
   pnpm install
   ```
3. Run the development server:
   ```bash
   pnpm dev
   ```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.