xonecas.io
8356
Wx

www-xonecas-io / files

www-xonecas-io / tickets / 1001-write-the-style-guide-for-the-chosen-direction.md

10.2 KB
1---
2id: 1001
3title: Write the style guide for the chosen direction
4type: feature
5status: done
6priority: p1
7area: design
8created: 2026-11-07T19:30:00Z
9updated: 2026-11-08T04:02:30Z
10source: agent
11moves: 2026-11-07T19:30:00Z inbox todo agent; 2026-11-07T21:43:23Z todo doing field; 2026-11-07T21:59:06Z doing blocked agent; 2026-11-08T00:49:17Z blocked todo note; 2026-11-08T00:49:25Z todo doing field; 2026-11-08T00:53:56Z doing blocked agent; 2026-11-08T00:58:33Z blocked todo note; 2026-11-08T00:58:43Z todo doing field; 2026-11-08T01:00:55Z doing blocked agent; 2026-11-08T01:08:41Z blocked todo note; 2026-11-08T01:09:38Z todo doing drag; 2026-11-08T01:21:20Z doing review agent; 2026-11-08T04:02:30Z review done drag
12---
13
14From 1000: the contact sheet has 20 directions.
15
16Needs from xonecas: the mock number to build on, or a mix of them. My recommendation is on 1000.
17
18Deliver a local /style page with the colour and type tokens, the tag treatment for the six tags, and these components: nav, project row, file tree, code block, diff, commit row.
19
20Done when: every component renders on /style at desktop and phone width (no horizontal scroll), in every theme the direction has. The IE5-era spirit stays: hand-written, little or no JS, no framework look.
21
22## Notes
23
24- 2026-11-07 21:43Z (human): Let's create another artifact, with some examples of different projects README, and home pages is the style of 02, 12, 20; 5 of each.
25  
26  More _app_ less personal page I guess is a subtle direction for these mocks. The creativity is good, but needs to be a generated, browsable git site. Think of the homepage as my "git profile".
27  
28  Dont advertise irvc or space browser.
29
30- 2026-11-07 21:59Z (agent): New artifact attached: 30 mocks, 10 for each of 02 Heat wall, 12 Blueprint and 20 Periodic table. The PNG is the overview. The live HTML opens each page full size, and you can scroll it.
31  
32  WHAT IS IN IT, PER STYLE:
33  - 5 homepages, each a different take on the git profile: an overview with pinned projects, a project list with filters and sort, an activity feed, and two pages built around that style's own chart.
34  - 5 project READMEs, the same 5 in every style so you can compare them: mini-coder (big, image, long docs), Zoea-Nova (534 files, images), ffmpeg-node (2011, 120 stars), vim-night-lights (GitHub and GitLab merged), and tiny-c-agent (no README, no description: the empty state).
35  - Every page has the same app header: Overview, Projects, Activity and search. Each project page has README, Files and Commits tabs and a clone URL.
36  
37  DATA: real, generated without hand edits. The 1000 summary covers all 82 projects. I made blobless clones of 14 public repos for the READMEs, file trees and commit feeds. Commit counts match 1000 (they count every branch). The pages are static HTML and use no JS. Only the sheet's open-full-size dialog uses a few lines of JS.
38  
39  CHOICES I MADE (easy to change):
40  - irvc is left out of every list, pin and feed, and nothing links to irvc or space-browser. The totals (82 projects, 2,770 commits) still include irvc, so the lists show 81.
41  - The clone URL is written as https://xonecas.io/projects/<name>.git. That is not decided yet (1002/1011).
42  - Images in READMEs are shown as labelled placeholders, not the real images.
43  
44  WHAT I FOUND:
45  - 20's element symbols depend on the order projects are added, so a new project can change existing symbols. It needs a fixed symbol per project to work on a live site.
46  - Some descriptions are cut off in the 1000 summary (for example Zoea-Nova '...within the Spa'). The real generator should read the full description.
47  
48  CHECKED: screenshots of all 30 at 1440x900, the sheet as a full-page PNG, and the dialog opening a page full size in headless Chromium.
49  NOT CHECKED: phone width, dark themes and the real images. The mocks need network access for Google Fonts. Feeds and per-month data come only from the 14 clones, so the 'other projects' count for Feb 2026 (23) is the remainder from 1000's monthly total.
50  
51  DECISION NEEDED for the /style page: 02, 12, 20, or a mix?
52  My recommendation: 02 Heat wall. It reads most like an app. The contribution grid is already how people read a git profile, and its parts (cell, pill, card, ramp) are the fewest components to build. 12 is the most distinctive but heavy to read in long READMEs. 20 is fun but needs the fixed symbols.
53
54- 2026-11-08 00:49Z (human): Ok I like 02 the best, but I want to explore it the style of 20, and dark mode alternative too. Let's do another attachment with 10 mocks, 5 dark, 5 light, with the layout of 02, in the style of 20.
55
56- 2026-11-08 00:53Z (agent): New attachment: 10 mocks with 02's layout in 20's style. The top row is the 5 pages in light and the bottom row is the same 5 in dark, so each page can be compared straight down. The PNG is the overview, and the live HTML opens each page full size.
57  
58  WHAT IS IN IT:
59  - Pages: Overview, Project list, Activity, mini-coder README, ffmpeg-node README. Together they show every component the /style page needs except diff, which none of 02's pages had.
60  - From 20: IBM Plex Sans Condensed and Plex Mono, square 2px corners, the Xo brand tile and underlined nav. Every project is an element tile: its colour is the group (frontend, backend, both, neither) and an outline means post-AI. Tiles lead the pinned cards, project rows and feed rows, and a large tile heads each project page.
61  - 02's heat in 20's palette. Light runs from pale yellow to amber to rust to ink. Dark runs from umber to bright yellow, so the busiest cell is the brightest. The big numbers are 20's inspector block: yellow on ink in light, ink on yellow in dark.
62  - Data, layout and markup are the 02 pages from the last attachment, recoloured by a script. Element symbols come from the 20 mocks.
63  
64  CHOICES I MADE (easy to change):
65  - I read '10 mocks, 5 dark, 5 light' as 5 pages, each in both themes. That leaves out Wall first, Project wall, Zoea-Nova, vim-night-lights and tiny-c-agent.
66  - 02's heat is now 6 fixed steps instead of a smooth ramp.
67  - The group colours are the same in dark, slightly dimmed. The tiles look like stickers on the dark page.
68  
69  CHECKED: screenshots of all 10 pages at 1440x900 in headless Firefox, and the sheet as a full PNG.
70  NOT CHECKED: phone width, and the dialog that opens each page full size (it uses the same code as the last sheet). Google Fonts still need network access. 20's element symbols still depend on the order projects are added (see the earlier note).
71  
72  DECISION NEEDED for the /style page: does 02 in 20's style become the direction, with both light and dark themes?
73
74- 2026-11-08 00:58Z (human): We got our initial style, we can shape it better as we go. for the favicon, top right icon, etc, see my photo on github, then generate 10 logos based on it, fitting out choosen style
75
76- 2026-11-08 01:00Z (agent): New attachment: 10 logos from the GitHub photo (live HTML and PNG). The xonecas and sacenox accounts have the same photo, so all 10 come from it. Each logo is shown at 192, 64, 32 and 16 px, in the app bar in light and dark, and as a browser-tab favicon. The photo is in the sheet's corner for comparison.
77  
78  THE 10:
79  - Traced from the photo's pixels: 01 Heat portrait (14x14 heat cells), 02 Group colours (16x16 snapped to ink, yellow, blue and grey), 03 One bit (24x24 ink on yellow), 04 Halftone (13x13 dots).
80  - Drawn from the photo's features (tousled hair, smiling eyes, full beard, grin, grey hoodie with drawstrings): 05 Face tile, 06 The beard, 07 Hoodie, 08 Xo (the face is the o), 09 Element (11 for 2011, 2770, Xo and the face), 10 Inverse (yellow on ink).
81  - Every one is a 64x64 SVG in the palette from the mocks. The SVG sources are inside the HTML.
82  
83  WHAT I SAW:
84  - At 16 px the drawn marks (05, 06, 08, 10) still read. The traced ones (01, 03, 04) turn to mush, and 02 holds up best of those four.
85  - 10 Inverse has no visible edge in the dark app bar, because its ink tile matches the background.
86  - 08 and 09 use text. In a favicon or img tag an SVG can't load Plex, so 09's numbers fall back to Arial Narrow or sans-serif. The final mark would need its text turned into paths.
87  
88  CHECKED: the sheet rendered in headless Firefox and read from the PNG.
89  NOT CHECKED: a real favicon in a browser tab, and phone width.
90  
91  DECISION NEEDED: which logo, or which mix, becomes the favicon and the top-left mark?
92
93- 2026-11-08 01:08Z (human): 01 is our icon.
94
95- 2026-11-08 01:21Z (agent): Done: /style renders every token, tag and component in light and dark, at desktop and phone width.
96  
97  WHAT IS ON /style (built by 'make build', served at /style/ by 'make serve'):
98  - Colour: every token, the four group tiles, the post-AI outline, a large tile, and the 7-step heat ramp, in light and dark side by side.
99  - Type: IBM Plex Sans Condensed 700/600/400, Plex Serif italic for captions, Plex Mono for code, and the big-number block.
100  - Tags: each of the six has a swatch. frontend is yellow and backend is blue, like the tiles. small and big are a small and a big ink square. pre-AI is a plain tile and post-AI an outlined tile.
101  - Components: nav, project-row, file-tree, code, diff, commit-row. Each is shown in light and dark.
102  - Icon: 01 Heat portrait is the favicon and the nav mark, at internal/site/static/logo.svg. It is 01 as attached, with the empty cells dropped (11 kB).
103  
104  HOW IT IS BUILT:
105  - Tokens live in internal/site/assets/site.css as Tailwind @theme colours. Each one is light-dark(), so the page follows the system theme and data-theme=light or dark forces one. There is one token list and no dark: classes.
106  - The components are Go template partials in templates/components.html, fed by the types in view.go. The pages for 1006, 1007 and 1009 will reuse them. The rows switch layout with container queries, so they fit whatever column they are in.
107  - There is no JavaScript.
108  
109  CHECKED: go vet and go test pass, and the build is idempotent. I took Firefox headless screenshots at 1440 and 390 px (attached). A check script injected into a scratch copy measured scrollWidth against the viewport: 1440/1440 and 390/390, so there is no horizontal scroll. Long code and diff lines scroll inside their own box.
110  NOT CHECKED: Chrome or Safari. light-dark() needs a 2024+ browser.
111  OPEN: fonts load from Google Fonts. Self-hosting them is a choice for later.