A visualization tool that displays GitHub contribution statistics as an interactive galaxy. Built with React, TypeScript, and Bun. Check it out at https://galaxy.partman.dev!
You can hover over a star for details and a link.
- Bun v1.2.21 or higher
- A GitHub account
- GitHub Personal Access Token (see setup instructions below)
Clone the repository and install dependencies:
git clone https://github.com/PartMan7/Galaxy
cd Galaxy
bun install(click to expand)
To fetch GitHub statistics, you need to generate a Personal Access Token:
Go to https://github.com/settings/tokens or:
- Click your profile picture
- Select Settings
- Navigate to Developer settings
- Click Personal access tokens
- Select Tokens (classic)
- Click "Generate new token" and select "Generate new token (classic)"
- Give it a descriptive name (e.g., "Galaxy Stats App")
- Set expiration date (recommended: 90 days or No expiration for development)
The following permissions are required:
read:user- Read all user profile datauser:email- Access user email addresses (read-only)
- Click "Generate token" at the bottom of the page
- Copy the token immediately (you won't be able to see it again)
Create a .env file in the project root directory:
PUBLIC_GITHUB_USERNAME=(Your username here)
VALID_GITHUB_USERNAMES="*" # This can be a comma-delimited list of names if you want to only allow specific names
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxReplace the placeholder values with your actual GitHub token and username.
Start the development server with hot reloading:
bun devThe application will be available at the default port with automatic reloading on file changes.
Contributions are welcome! If you're new to contributions, check out GitHub's guide on how to contribute.
- Fork the repository
- Create a new branch for your feature or bug fix
- Make your changes and commit them with descriptive messages
- Push your changes to your fork
- Submit a pull request with a clear description of your changes