# Codex Stellarum

> Transform your GitHub contribution history into a vintage astronomical star atlas - a personalised fine art print of your code, rendered as a celestial chart. Each commit becomes a star, each year a constellation. Permanent, physical, beautiful.

## Pages

- [/](/): Create your personal star atlas from any GitHub profile, repository, or organisation. Choose from six vintage layout formats, custom date ranges, and themes including Observatory, Parchment, and Blueprint.
- [/about](/about): The story behind Codex Stellarum - why code deserves to be remembered as art, and how a GitHub contribution graph became the foundation for permanent archival prints.
- [/business](/business): Custom star atlases for engineering teams and organisations. Bulk pricing, branded editions, and commemorative prints for milestones, launches, and team anniversaries.
- [/blog](/blog): The Codex Stellarum journal - essays on data visualisation, digital archaeology, developer culture, and the craft of turning code into art.
- [/blog/how-we-built-codex-stellarum](/blog/how-we-built-codex-stellarum): A technical deep-dive into the architecture, rendering pipeline, edge functions, and print fulfilment system that power the site.
- [/blog/github-achievements-explained](/blog/github-achievements-explained): Every GitHub Achievement badge, explained - what they mean, how to earn them, and why they matter.
- [/blog/gifts-for-coders](/blog/gifts-for-coders): Gifts for coders: what they will actually use in 2026.
- [/blog/what-is-the-github-contribution-graph](/blog/what-is-the-github-contribution-graph): What the GitHub contribution graph actually is, how it counts contributions, and what it reveals about how developers work.
- [/blog/best-gifts-for-a-computer-person](/blog/best-gifts-for-a-computer-person): The best gifts for a computer person (2026) - curated, practical, and genuinely useful.
- [/blog/data-visualization-as-art](/blog/data-visualization-as-art): Data visualization as art: a short history of beautiful information, from early cartography to modern generative design.
- [/blog/what-archaeologists-will-think](/blog/what-archaeologists-will-think): A thousand years from now, our contribution graphs may be the only surviving record of how software was built. What will they tell the archaeologists?
- [/blog/github-wrapped-but-permanent](/blog/github-wrapped-but-permanent): Spotify Wrapped made personal data feel like art. Developers deserve the same thing - but built to last longer than a Stories post.
- [/blog/moments-in-a-developers-career-worth-marking](/blog/moments-in-a-developers-career-worth-marking): The 10 moments in a developer's career worth marking - first commit, shipping day, and the ones that changed everything.
- [/blog/home-office-decor-for-developers](/blog/home-office-decor-for-developers): The best home office decor for developers who work remotely - practical, beautiful, and built to last.
- [/blog/how-to-turn-github-contributions-into-art](/blog/how-to-turn-github-contributions-into-art): How to turn your GitHub contributions into art - a step-by-step guide to creating your own star atlas.
- [/blog/office-art-for-engineering-teams](/blog/office-art-for-engineering-teams): Office art for engineering teams that is not a motivational poster.
- [/blog/what-to-buy-the-developer-you-love](/blog/what-to-buy-the-developer-you-love): What to buy the developer you love - gifts that mean something.
- [/blog/why-we-built-codex-stellarum](/blog/why-we-built-codex-stellarum): The origin story - why we built Codex Stellarum and what we believe about code, memory, and art.
- [/blog/the-dark-spaces](/blog/the-dark-spaces): The empty squares in a contribution graph are not failure. They are the negative space that makes the stars visible.
- [/blog/the-commons](/blog/the-commons): The open-source maintainers whose invisible labour holds the internet together - and why their contribution graphs deserve recognition.
- [/blog/the-palimpsest](/blog/the-palimpsest): Layers of code written over time, like a palimpsest - the story of how software is built in iterations.
- [/blog/the-commit-graph-is-a-self-portrait](/blog/the-commit-graph-is-a-self-portrait): Your commit graph is a self-portrait. It reveals how you work, when you work, and what you care about.
- [/blog/gifts-for-developers-who-have-everything](/blog/gifts-for-developers-who-have-everything): Gifts for coders, programmers, and software engineers who have everything.
- [/blog/four-centuries-of-mapping-the-sky](/blog/four-centuries-of-mapping-the-sky): Four centuries of mapping the sky - the history of star charts and how they influenced the Codex Stellarum aesthetic.
- [/blog/the-best-code-is-written-in-the-dark](/blog/the-best-code-is-written-in-the-dark): The best code is written in the dark - on night owls, deep focus, and the rhythm of creation.
- [/blog/your-data-your-mirror](/blog/your-data-your-mirror): Your data, your mirror - what our digital traces reveal about who we are.
- [/blog/nothing-to-hold](/blog/nothing-to-hold): Nothing to hold - on the fragility of digital memory and why physical prints matter.
- [/blog/three-shapes-of-time](/blog/three-shapes-of-time): Three shapes of time - how different layout formats represent the passage of code history.
- [/blog/the-rosette-layout](/blog/the-rosette-layout): The Rosette layout - concentric rings of weekly time, inspired by astronomical instruments.
- [/blog/the-helix-layout](/blog/the-helix-layout): The Helix layout - a spiral form for visualising long-term contribution history.
- [/blog/the-planisphere-layout](/blog/the-planisphere-layout): A 5,000-year-old astronomical instrument reimagined as a layout for code history - concentric rings of time.
- [/blog/the-chronicle-layout](/blog/the-chronicle-layout): The Chronicle layout - a linear, journal-like view of your code history.
- [/blog/connecting-the-dots](/blog/connecting-the-dots): Connecting the dots - how we map commits to stars and create meaning from raw data.
- [/blog/seven-ages-of-the-developer](/blog/seven-ages-of-the-developer): Seven ages of the developer - the career arc from first commit to maintainer emeritus.
- [/blog/the-shape-of-your-code](/blog/the-shape-of-your-code): How contribution graphs reveal the invisible architecture of a developer's working life - bursts, pauses, and the cadence of creation.
- [/chart/:username](/chart/:username): The atlas preview and configuration page. Enter any GitHub username to generate a live preview, adjust themes, layouts, date ranges, and sizes before ordering.
- [/repo/:owner/:repo](/repo/:owner/:repo): Generate a star atlas for a specific GitHub repository. Visualises the commit history of a project rather than an individual profile.
- [/org/:orgname](/org/:orgname): Organisation redirect page. Resolves an organisation name to its top repositories and points visitors to repository-specific prints.
- [/checkout](/checkout): Secure Stripe checkout for fine art prints and digital downloads.
- [/basket](/basket): Shopping cart for mixed baskets of prints and digital downloads.
- [/order/success](/order/success): Order confirmation page displayed after successful checkout.
- [/render-print](/render-print): Internal print rendering route. Generates high-resolution atlas images for production fulfilment.
- [/github-poster](/github-poster): Open Graph image generator. Produces shareable preview cards for social media.
- [/guestbook](/guestbook): Testimonials and kind words from developers who have received their star atlases.
- [/refund-challenge](/refund-challenge): Interactive refund policy page.
- [/privacy](/privacy): Privacy policy - what data is collected, how GitHub profiles are processed, and how personal information is protected.
- [/terms](/terms): Terms of service - ordering, fulfilment, intellectual property, and the relationship between digital previews and physical prints.
- [/refunds](/refunds): Cancellation, refund, and return policies for fine art prints and digital downloads.

## Products

- **Fine Art Prints**: Unframed Giclée prints on archival matte paper, available in A3, A2, and A1 sizes. Printed with pigment inks rated for 100+ years.
- **Digital Downloads**: High-resolution PNG files of your star atlas, delivered via signed URL. Non-refundable once generated.
- **Custom Commissions**: Bespoke atlases for engineering teams, companies, and open-source projects. Branded editions available.

## Technical Notes

- GitHub data is cached with a 7-day incremental refresh strategy.
- All prints are fulfilled via fine art print partners with global shipping.
- Orders are processed through Stripe with webhook-driven fulfilment.
- The site uses Supabase for data persistence and edge functions for serverless operations.
- Sitemap and structured data (JSON-LD) are generated automatically for all pages and articles.

## API

- [OpenAPI specification](/openapi.json): Machine-readable description of the public routes and resources on the site.