Repolis — the City of Repos

Fastest proof: open Try my GitHub, type your login, and walk through your public repos. No token, account connection, or fork is required.

If this gives you a useful way to present repositories, star Repolis — it helps other developers discover the template.

Forks automatically infer <owner>.github.io as the town owner and do not call the upstream AI or realtime Workers. Custom domains set one value in repolis.config.js.

Repolis turns public GitHub metadata and cumulative traffic into a place instead of another dashboard.

Repositories are grouped into topic districts with roads, signs, hubs, and a world map. The owner town refreshes daily from committed traffic history plus the GitHub API; ?user=<login> can build a lighter town from any user's public repositories. At ordinary walking distances, a one-draw architectural LOD keeps each repo house's textured walls and roof while preserving its plot, hedge, path, real window panes, shutters, sills, flower boxes, gutters, and tier-specific porch, balcony, or portico.

• Residents have lives, not idle loops. Named townspeople wander their districts, keep daily rhythms, carry changing moods, visit cherished haunts, recognize friends, stroll and sit together, gather around the campfire, and sometimes celebrate a recent repository release. Their cottages form Starlight Row on the north-east edge, with resident-coloured gardens, three roof silhouettes, shutters, transoms, selected window boxes, canopies, chimneys, and roof finials. A shared flower bed, lanterns, hedges, and broadleaf/cypress trees care for the commons. Night brings residents home to warm windows and porch seats, while morning sends them back to their district work. Pairs also choose their own short Shared Joy excursions to real flower patches, visible night stars, or a real repo house—without a player prompt or AI call. Ask a specialist question and they introduce the right scholar instead of pretending to know: follow the compass and find that scholar in the world.
• Exploration has continuity. The Explorer Passport records houses and landmarks, district progress shows what remains, and the daily Village Chronicle connects one resident to their cherished haunt and a truthful related repo or district.
• Every repo house opens into one real room. Its card leads to the reusable Repository Atelier: a walkable 3D exhibition whose Repository Core, history/data wall, and action terminals rebind deterministically to that repo. Entering costs no network or AI call; GitHub and Gitber run only when you choose a terminal.
• Daily refresh now means something on return. The Passport's Town Gazette compares the current public repo snapshot with the last one this browser marked read, then highlights new repos, release tags when available, pushes, and positive metric growth. It is entirely local and costs nothing.
• Repositories form relationships. The Stargazer's Observatory finds a truthful three-repo connection from shared topics or languages and draws it as a nighttime Constellation Trail.
• Quiet maintenance gets its own light. The Observatory's Maintainers' Night Watch picks three recently tended, low-star repositories from public metadata and asks visitors to light their lanterns—celebrating care, not popularity.
• Landmarks carry the project story. The Contribution Library archives papers, talks, open-source work, and awards; Chronopolis hosts the Council of Time; the plaza, observatory, park, and fairground make the city worth walking. At Petite-Venise, a boardable low-profile ferry follows the real canal curve beneath the flower bridges for one scenic town tour.
• The World Tree anchors the skyline. It is a deterministic, code-native Three.js sculpture generated through the threejs-sculpt-dna Copilot plugin, with rooted foliage, living motion, and tree-isolated bloom.

The town works without a backend. Local search is instant and keyless; WebLLM is optional in-browser inference; the live demo adds grounded answers and official public MCP lookups through a Cloudflare Worker. Missing services degrade to Local search or solo play.

git clone https://github.com/hyeonsangjeon/Repolis
cd Repolis
python3 -m http.server 8000
# open http://localhost:8000

There is no install or build step. Three.js is loaded from a CDN import map; local data and modules are served as static files.

To rebuild the owner city from GitHub plus collected traffic history:

gh auth login
GTM_DIR=data python3 scripts/build_repos.py

repos.json is generated. Change the builder, never the generated JSON by hand.

The quickest preview needs no fork: open Try my GitHub or share https://hyeonsangjeon.github.io/Repolis/?user=<login>.

For a persistent metadata-built city:

1. Click Use this template.
2. Enable Actions, then enable GitHub Pages from main at the repository root.
3. Run Refresh Repolis data once; the workflow uses github.token to build from the template owner's public repos and continues daily.
4. Optional: add an Actions secret named GH_PAT to collect cumulative traffic. Without it, stars, forks, recency, language, topics, and releases still build the city.

Only public repositories are rendered. Untouched mirror forks are filtered out, and private repository names never enter the public data.

traffic history + GitHub API
             │
             ▼
 scripts/build_repos.py ──▶ repos.json
                                │
                                ▼
                    index.html + local modules
                         Three.js town
                         ├─ Local search
                         ├─ optional grounded AI Worker
                         └─ optional realtime Worker

Repolis stays a zero-build static web app. The main runtime remains in index.html; specialized local files hold generated data, the scholar roster, the World Tree factory, and deterministic Council logic.

• AGENTS.md — contributor and agent operating contract
• docs/domain-model.md — repository data and feature model
• docs/known-limitations.md — intentional constraints
• SCHOLARS.md — scholar roster and grounding roles
• COUNCIL_PATTERN.md — the debate-to-judge pattern
• CHANGELOG.md — recent releases and archive links
• repolis.yaml / llms.txt — machine-readable project entry points

MIT © Hyeonsang Jeon. Data collection credit: github-traffic-monitor.