Astrolabe

Visualize any GitHub user's starred repositories. Enter a username, get instant insights.

Explore the Live Demo »

English | 简体中文

---

📋 Table of Contents

• ✨ Features
• 📸 Preview
• 🚀 Quick Start
• 🛠️ Tech Stack
• 📁 Project Structure
• 📄 License

✨ Features

• Language Distribution: Visualize programming language usage across starred repositories.
• Star Timeline: Interactive timeline chart showing when repositories were starred.
• Repository Health: Automatically classify repositories as active, stale, abandoned, or archived.
• Search & Filter: Powerful search capabilities to find specific starred repositories instantly.
• Direct Navigation: One-click access to the original GitHub repository.
• No Auth Required: Works directly with GitHub's public API without needing personal access tokens.

📸 Preview

Dashboard Overview

Repository Details

Kanban & AI Prompts

🚀 Quick Start

Option 1: Docker Compose (Recommended)

1. Clone the repository:

   git clone https://github.com/dengshu2/Astrolabe.git
   cd Astrolabe

2. Create the required proxy network:

   docker network create proxy-network || true

3. Start the application:

   docker-compose up -d

4. Open your browser and visit http://localhost:3002

Option 2: Run from Source

1. Clone the repository:

   git clone https://github.com/dengshu2/Astrolabe.git
   cd Astrolabe

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open your browser and visit http://localhost:5173 (default Vite port)

🛠️ Tech Stack

• Frontend Framework: React 19
• Language: TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS 4
• Visualization: Recharts
• API Integration: GitHub REST API (native fetch, no auth required)
• Icons: Lucide React

📁 Project Structure

Astrolabe/
├── dist/                # Production build artifacts
├── images/              # Project screenshots
├── public/              # Static assets
├── src/                 # Source code
│   ├── api/             # GitHub API client
│   ├── components/      # Shared UI components
│   ├── features/        # Feature modules (dashboard, repos, prompts, landing)
│   ├── hooks/           # Custom React hooks
│   ├── i18n/            # Internationalization (en / zh)
│   ├── lib/             # Utilities, caching, constants
│   └── types/           # TypeScript type definitions
├── docker-compose.yml   # Docker Compose configuration
├── Dockerfile           # Docker build instructions
├── index.html           # Entry HTML file
├── package.json         # Project metadata and dependencies
├── tsconfig.json        # TypeScript configuration
└── vite.config.ts       # Vite configuration

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.