In 1220, the master builders at Chartres faced a structural problem. The north transept wall was enormous, load-bearing, and almost entirely blank. They could not fill it with narrative reliefs because the stone was structural. They could not pierce it with a grid of small windows because the light would be wrong. What they built instead was a single circular opening nearly eleven metres across, divided by stone ribs radiating from a central roundel to concentric rings of glass, each ring further divided by radial lines into segments of colour and story.
It was not decoration. It was information. In a congregation that could not read, it was a map of the cosmos, a calendar of the saints, a diagram of creation. Light passed through it and made meaning.
The geometry has not changed. It is still the most efficient shape for displaying a full cycle of data around a fixed centre, and there is one domain of modern life where that matters more than anywhere else: the career of a long-tenured developer, or the contribution history of an organisation that has been building software for a decade.
THE WINDOW AND THE WHEEL
The rose window arrived in northern France in the early 12th century, but the geometry behind it was older and came from further away. Islamic craftsmen had been constructing interlocking geometric patterns (circles divided by radial lines, concentric rings subdivided into equal segments) for at least three centuries before the first Gothic cathedral broke ground. Their source was partly astronomical. The astrolabe, an instrument used to map the visible sky, is a flat disc with concentric rings marked by angular divisions. The planisphere, used to show which stars are visible at a given time of year, is a rotating pair of discs, each divided into rings and segments corresponding to the coordinate grid of the celestial sphere.
The Gothic master builders absorbed this geometry and gave it new meaning. The concentric rings represented the hierarchy of heaven. The radial divisions marked time: the calendar, the saints' days, the turning year. The central roundel held Christ or the Virgin. The whole window was simultaneously a scientific instrument and a theological argument.
What made it work was the density. A rose window divided into 52 segments per ring does not feel sparse. It feels complete. The eye moves around the circumference and finds something in every segment. The circle closes on itself and the sense of totality is immediate.
Fifty-two is not an arbitrary number. There are 52 weeks in a year.
THE GEOMETRY OF A WORKING YEAR
The Rosette layout renders a GitHub contribution history as a rose window. Each year of activity becomes a concentric ring, with the most recent year at the outside and the earliest at the centre. Each ring is divided into 52 equal segments, one for each week of that year, radiating from the hub. The brightness of each segment reflects the weight of contributions in that week: commits, pull requests, code reviews, issues opened and closed.
The choice of 52 weekly segments per ring is not aesthetic convenience. It is the right resolution for code data.
Daily resolution is too noisy for any view longer than a few months. The day-to-day variance in commit counts reflects interruptions, meetings, travel, illness, the morning spent in a design review instead of at a terminal. None of that variance is meaningful at the scale of a career. Monthly resolution is too coarse in the other direction: a month is long enough to conceal the sprint cycle entirely, to average away the difference between the week a team shipped a major release and the recovery week that followed. The week is the natural unit of software development. The sprint. The weekly standup. The pull request that opened on Monday and merged on Friday. The week of hotfixes after a bad deploy. The quiet week between Christmas and new year. The week a side project suddenly got traction.
At weekly resolution, the patterns that actually matter become visible. Which weeks are consistently bright across every ring: the spring sprint before the annual conference, the September push before the fiscal year closes, the burst of energy in January. Which weeks are reliably dark: the August slowdown when half the team is on leave, the two weeks in December that every organisation knows but nobody schedules around. The Rosette makes those patterns structural. They repeat in the same angular position across every ring, and the eye finds them without instruction.
Real celestial instruments divide their coordinate rings into units that map directly onto the calendar. The planisphere is usable precisely because its divisions match the astronomical year. A contribution chart with 52 weekly segments per ring inherits that tradition directly. The data fits the instrument. The instrument fits the data.
LIGHT THROUGH GLASS
For organisations and long-tenured developers (contributors with five, ten, fifteen years of activity on record), the Rosette exists because no other layout could hold the data with the same legibility. A linear chart becomes a narrow ribbon stretched across a screen, too long to print, too compressed to read. A grid arrangement runs out of vertical space and forces the viewer to scroll through years that should be visible simultaneously. The Rosette adds a new ring for each year and keeps the full history at once, at the same scale, in the same field of view. The oldest contributions sit at the centre like the original stone of the roundel. The newest ring at the edge carries the most recent season on its outer circumference.
This is why the Rosette is the default layout for organisations in Codex Stellarum, and why it is well suited to individual contributors with long careers. An organisation's contribution history is dense, layered, and genuinely cyclic. It has seasons that repeat. It has patterns that only become legible when multiple years are visible at the same time.
What the Rosette reveals about an organisation goes further than simple activity levels. Brighter outer rings often reflect team growth: more contributors, more concurrent projects, more pull requests in flight at once. The texture of successive rings tells the story of how a team matured. Early rings tend to be spiky, with a few very bright segments and long stretches of darkness: a small team shipping in bursts. Later rings tend to be smoother and more uniformly lit, the signature of a larger team with established processes, regular sprint cadences, and distributed ownership. You can see the moment an organisation stopped being a startup.
The same logic applies to individual developers. A junior developer's early rings are characteristically uneven: intense periods of learning broken by gaps, the jagged output of someone still finding their working rhythm. Senior developer rings look different: steadier, more consistent, with the occasional bright cluster marking a major feature or a difficult migration rather than a frantic scramble to keep up. The transition between those two textures, visible across successive rings, is the shape of a developer growing into their craft.
The medieval congregation at Chartres did not read the rose window as a diagram. They experienced it as light. The theological argument arrived through colour and luminosity, through the sensation of a dark interior suddenly crossed by coloured beams at a particular hour of the day. The data was encoded in glass, and glass needed light. The Rosette works by the same logic. Brightness maps to activity. Position maps to time. The circular form makes the cyclical nature of a working year visible in a way that a list of numbers never can. You do not need to read the axes to understand a ring that is bright all the way around versus a ring with one bright quadrant and three dark ones. The difference is immediate.
THE MOST CELESTIAL LAYOUT
Codex Stellarum offers four layouts. The Chronicle renders contributions as a vertical timeline, layered like geological strata. The Planisphere maps the year onto a circular disc, the astronomer's star chart flattened into a single season. The Helix traces a spiral outward from the centre, one revolution per year, good for showing a career as a continuous thread. Each layout has its logic.
The Rosette is different in character. It looks, more than any other layout in the collection, like a scientific instrument. The concentric rings. The radial divisions. The dense, even segmentation that gives the whole disc a sense of completeness even before you examine any individual ring. Hold it at arm's length and it could be a planisphere pulled from a navigator's chart case. It has the visual grammar of a tool built for reading the sky.
This is not accidental. The same geometric tradition that produced the astrolabe produced the rose window. The same division of a circle into equal angular segments that lets an astronomer read right ascension from a coordinate disc lets a viewer read a full year of weekly contributions from a single ring. The instrument shape carries authority precisely because it was developed over centuries for the serious purpose of measuring and displaying cyclic phenomena.
A developer's contribution history is cyclic. It has seasons. Projects begin and accelerate and end. Months of low output follow periods of intensity. Years of growth alternate with years of consolidation. The code changes. The language changes. The problems change. The rhythm does not. The Rosette makes all of that visible at once, in a form that humans have been trained by eight centuries of scientific and sacred geometry to read instinctively.
THE CIRCLE CLOSES
The word "rose" was not applied to these windows until the 17th century. For the builders who created them, they were simply wheels. Rota, in Latin. The wheel of fortune. The wheel of the year. The wheel of the cosmos turning around its fixed centre.
There is something right about that older name. A wheel implies motion. A wheel implies a centre that does not move while the rim turns around it. The Rosette layout has the same structure: the innermost ring is the oldest year, fixed and unchanging, while each new year adds a ring at the outside and the whole disc grows outward in time. The centre holds. The edge moves forward.
The builders at Chartres were trying to put the entirety of sacred history into a circle of glass. The geometry forced clarity. Everything had to fit, every segment had to earn its place, and the whole had to cohere into a single legible image that a stonecutter's apprentice at the back of the nave could understand without instruction.
That is still the right constraint. The best visualisation makes the shape of the whole visible at a glance, before analysis begins. Ten years of a developer's working life. A decade of an organisation's output. All of it in one circle, every ring in place, every week accounted for.
The window does not need explaining. Neither should the chart.
Explore the Rosette layout and every other layout in the collection at codexstellarum.com. Enter your GitHub username to preview your atlas free, with prints from £25.