Sign In With GitHub
CommitCrown has no password system. Your GitHub account is the key to your kingdom — click the sign-in button and you'll be redirected to GitHub's official OAuth authorization page in seconds.
CommitCrown is requesting permission to access your public profile and repository data.
Read-only · No write access · No password stored
Once you click Authorize CommitCrown, GitHub issues a short-lived token and redirects you back. CommitCrown reads your public profile, your repository list, and your contribution graph. Nothing is written back to your GitHub account — ever.
We request two scopes: read:user (so we can read your username, avatar, and bio) and repo (so we can list your public repositories). That is the full extent of the permissions.
Kingdom Creation
The first time you sign in, CommitCrown analyses your entire GitHub contribution history — up to 90 days — to seed your starting kingdom with the right amount of resources, buildings, and prestige.
Your Kingdom Awaits
The analysis takes 10–30 seconds depending on how active your GitHub history is. During this time CommitCrown counts your commits, catalogues your repositories, detects programming languages, and calculates your longest streak.
Once complete, your kingdom is assigned a permanent, public URL: commitcrown.app/realm/your-github-username. Share this URL with friends, add it to your GitHub README, or let rivals discover it on the world map.
Dashboard Overview
Your dashboard is the heart of CommitCrown — an isometric map of your kingdom surrounded by a HUD that displays all your live resources, army power, and quick-action buttons.
The top bar shows your four primary resources (Gold, Wood, Stone, Food) and your total Army Power. Resources update every time GitHub sync runs. The bottom action bar lets you open the Build Menu, trigger a manual sync, launch a Raid, navigate the World Map, and visit the Shop.
The isometric map shows every building you have placed, with each district corresponding to a cluster of repositories. Click any building to inspect its level, output stats, and upgrade options.
B to open the build menu, R to start a raid, and W to open the world map — all without reaching for your mouse.Resources Explained
CommitCrown has five resources, each derived directly from your GitHub activity. Nothing is purchased with real money — everything is earned through code.
| Resource | Source | Used For |
|---|---|---|
| ⚒️ Gold | Total commits | Buildings, upgrades, shop |
| 🌲 Wood | Repository count | Defensive structures |
| 🪨 Stone | Streak days | Walls, towers |
| 🌾 Food | Lines of code | Army upkeep |
| ✨ Prestige | All activity combined | Rank, leaderboard position |
Resources are recalculated every time your kingdom syncs with GitHub. Keep committing, keep building new repositories, and maintain your streak — all three actions grow your resources simultaneously.
Placing Buildings
Open the Build Menu (B) to see every building available at your current progression level. Each building costs a combination of resources and grants a permanent bonus to your kingdom.
CommitCrown has six building types at launch, each serving a different strategic role:
- ⚔️ Barracks — converts your commit streak into raw Army Power. Essential for raids.
- 🏦 Treasury — generates passive Gold per hour based on your total repository count.
- 🌾 Granary — increases your Food storage cap so your army can grow larger.
- 🗼 Watch Tower — boosts defensive stats when your kingdom is under raid by a rival.
- 📚 Library — unlocks at 10 repositories. Provides a technology bonus to all building outputs.
- 🔭 Observatory — unlocks at level 5 Prestige. Generates passive Prestige per hour.
Upgrading Buildings
Every building can be upgraded up to level 10. Each level multiplies the building's output by ×1.2, compounding over time into significant power advantages.
To upgrade a building, click it on your isometric map (or select it from the building list on mobile) and press the Upgrade button. The cost increases at each level, so plan your upgrades strategically.
| Level | Output multiplier | Approx. Gold cost |
|---|---|---|
| 1 → 2 | ×1.20 | 400 Gold |
| 2 → 3 | ×1.44 | 640 Gold |
| 3 → 4 | ×1.73 | 960 Gold |
| 4 → 5 | ×2.07 | 1,200 Gold |
| 9 → 10 | ×5.16 | 6,400 Gold |
Streaks & Army Power
Your commit streak is the single most powerful variable in CommitCrown. The longer your unbroken streak, the stronger the unit type your Barracks trains — dramatically multiplying your Army Power.
A streak is defined as making at least one commit on GitHub for consecutive calendar days. The streak counter resets at midnight UTC. As your streak grows, your Barracks automatically promotes the unit type it trains:
| Streak Length | Unit Type | Army Power Bonus |
|---|---|---|
| 1 – 7 days | 🗡️ Infantry | Base |
| 8 – 14 days | 🐴 Cavalry | +35% |
| 15 – 30 days | 💣 Siege | +80% |
| 31+ days | 👑 Elite Guard | +150% |
GitHub Sync
CommitCrown reads your GitHub data once a day at 00:00 UTC automatically. All new commits, repositories, languages, and streak changes since the last sync are applied to your kingdom in a single atomic update.
You can also trigger a manual sync from the dashboard at any time — but there is a one-hour cooldown between manual syncs to prevent abuse. The manual sync button shows the remaining cooldown time when it cannot be used.
After each sync you will see a brief activity feed inside the Sync panel: how many commits were detected, whether your streak was extended, which repositories were updated, and how your resources changed. These events are also logged permanently in your Chronicle (see Step 04).
Explore Other Realms
Press W or tap the World Map button to leave your own kingdom and explore the wider CommitCrown world. Every kingdom on the platform appears here, with real-time prestige and raid statistics.
The world map displays kingdoms as castle icons on a strategic grid. You can filter by prestige range, language, or raid activity to find suitable targets or allies. Clicking a kingdom opens its public profile — showing its building layout, resource totals, streak history, and raid record.
Visiting another kingdom does not trigger any interaction — it is purely informational. Use it to scout before declaring a raid, find inspiration for your own build, or just admire the leaderboard elite.
Initiating a Raid
When you are ready for PvP, open the Raid panel from a target kingdom's profile and challenge them to a 7-day war. The kingdom with the highest total raid points at the end of 7 days wins.
1 active raid at a time · Cannot be cancelled
Before declaring war, you choose a strategy that modifies how your commits are scored during the raid:
- Siege — rewards sustained, consistent committing. Every commit scores, with a +40% bonus to your base attack stat.
- Skirmish — raw commit volume wins. No attack bonus, but quantity is weighted more heavily than commit quality.
- Infiltration — targets your opponent's weakest resource. Effective against kingdoms with low Watch Tower levels.
During a Raid
A raid is decided by Raid Points accumulated over 7 days. You earn raid points by committing to GitHub — your daily GitHub sync automatically converts those commits into raid points using the following formula:
Your Raid Panel updates every time your kingdom syncs. You can see the running totals for both sides, a day-by-day feed of activity, and a live status indicator showing who is currently winning.
The raid ends automatically at 00:00 UTC on Day 8. The winner receives a +15% Prestige bonusadded to their kingdom's total. The loser receives nothing — but loses no existing Prestige. Raids only reward; they never take away.
The Leaderboard
The global leaderboard ranks every kingdom by cumulative Prestige. There are four tiers, and the top rulers of each season are permanently inscribed in the Hall of Legend.
| Tier | Prestige Required | Reward |
|---|---|---|
| 🪖 Recruit | 0 – 24,999 | Access to all features |
| 🛡️ Knight | 25,000 – 74,999 | Exclusive Knight banner |
| 🏆 Champion | 75,000 – 124,999 | Animated Champion aura + banner |
| ⚜️ Legend | 125,000+ | Hall of Legend inscription + Legendary crown cosmetic |
Seasons run for three calendar months. At the end of each season, the top 10 Legend-tier rulers of that season are permanently displayed in the Hall of Legend — accessible from the landing page of CommitCrown for all time. Season rewards are cosmetic only; your Prestige total carries forward into the next season.
Shop & Cosmetics
The CommitCrown Shop sells cosmetic items that change the visual appearance of your kingdom. All items are purchased exclusively with Gold — the in-game resource earned from commits. No real money is involved, ever.
The shop has five categories:
- Terrain — changes the ground texture of your isometric map (volcanic, arctic, desert, etc.).
- Skins — full visual reskins for your kingdom (night realm, ember realm, ocean realm).
- Banners — decorative flags placed in your kingdom and displayed on the world map.
- Effects — ambient particle effects around your castle (gold shimmer, ember aura, frost mist).
- Prestige items — special cosmetics unlocked only by reaching Champion or Legend tier.
Some items are season-limited — available only during a specific season and never returning to the shop. If you see something you want and have the Gold, buy it during its season window.
Video Walkthrough
Prefer to watch rather than read? The full CommitCrown gameplay walkthrough covers all 13 steps with live in-game footage — kingdom creation, building placement, raiding, and the leaderboard.