AUDIT.md — current state of ak1.io
Written before starting Workstream 1, from reading the repo (not just rendered
HTML). Where this contradicts AK1-BRIEF.md, the repo wins and it is noted.
Stack (corrections to brief)
- Jekyll 4.4.1, not 3.10 as the brief states.
jekyll-sass-converter3.1 is present, so SCSS is available if we want it (currently unused — plain CSS). - Plugins:
jekyll-seo-tag,jekyll-sitemap,jekyll-feed— all present. - No build step beyond Jekyll. Two CSS files:
css/style.css(hand-written, 843 lines, single file) andcss/bootstrap-grid.css(grid utility — appears largely unused by current markup; candidate for removal later). - JS:
js/load.js(theme toggle, social icons, scroll state) andjs/toc.js.
Type scale in use (Workstream 1 target)
Ad hoc, not tokenised. Fonts loaded from Google Fonts (Poppins 100–600,
Quicksand 300–700) via <link> with display=swap — not self-hosted, not
preloaded. Body is Quicksand 500; headings Poppins. Sizes are a mix of
em, px, and clamp() with per-element line-heights. No modular scale, no
--font-size-* tokens.
Colour / theming (Workstream 1 target)
- Dark is default;
body.light-modeoverrides. Toggled bydayNightToggle()injs/load.js, persisted inlocalStorageunder keylight-mode. - Tokens exist as CSS custom properties (
--bg --fg --muted --soft --line --line-strong --card --card-hover --accent) — good foundation. - But they are raw hex +
rgba(), not Radix scales, and there are raw colour literals scattered in component CSS (shadowsrgba(0,0,0,.55), accent glowsrgba(233,196,106,...),#1d1e21in::selection). Not tokenised to the brief’s standard. - No spacing tokens; padding/margins are magic px values throughout.
Motion (Workstream 7 — partially done already)
@view-transition { navigation: auto; }already present with a tuned root cross-fade (css/style.css:281). Header/footer are not named, no shared-element banner morph, no nav-indicator, no circular-reveal theme toggle.- Home hero has an entrance animation (staggered
home-rise) — the brief’s MOTION.md §7 explicitly says no entrance animation on hero text. Conflict to resolve in W7/W2. - A
prefers-reduced-motionblock exists but only covers the hero + view transition, not the global*reset MOTION.md §6 wants. consult-pulsekeyframe pulses the availability dot (gated for reduced motion).
What the brief lists as TODO but is ALREADY DONE
- W4 Twitter handle:
_config.ymlalready setstwitter.username: _akshay22andtwitter.card: summary_large_imageglobally. The@Akshay Sharmabug is already fixed. (seo-tag emitstwitter:creatorfromtwitter.username.) - W4 RSS discoverability:
<link rel="alternate" type="application/atom+xml">is present in_layouts/default.html. - W4 sitemap:
jekyll-sitemapactive. - W4 post og:image: every post has
image+image_altfront matter; seo-tag emitsog:imagefrom it. - GA4: already wired, production-only (
_layouts/default.html:24). - Sticky nav +
aria-current: present and correct. - Footer (email/RSS/GitHub/Redigit): present.
llms.txt: present, live from_data/projects.yml+site.posts.- Consulting badge on home: present (
home-consult).
What is genuinely still open
- W1 Typography + real tokenisation (Radix, modular scale, spacing, self-host fonts). Not done.
- W2 Homepage still shows only avatar + one line + “Read the journal →”. No work above the fold. Not done.
- W3 Projects: one flat list of 7 cards, no split, no install lines, no
versions, no platform badges, no stars.
_data/projects.ymlhas onlyname/stack/lang/description/repo/post. Not done. - W4 (remainder)
/projects/and/blog/have noimagefront matter, so they share as bare text despite the globalsummary_large_imagecard. Need an OG image for each (or per-section default). - W5
.DS_Storeandimg/.DS_Storeare committed and.gitignoredoes not list.DS_Store. SVGO not run. Images mostly lack width/height. No.editorconfig. README has no fork note. - W6 Redigit funnel is one sentence + link. No
/hire/page, no post-level CTA. - W7 Motion: see above — mostly open.
- W8 Banner alt text:
shipping-small-useful-improvementsalt is generic (“Abstract code editor banner for a software blog post”). Generated banner system not built. - W9 No DrawBox demo.
- W10 Arrows on nearly every link (
Read the journal →,View on GitHub →,Read post →,Read the story →); all-caps tracked eyebrows everywhere; homepage positioning line is the generic “building thoughtful cross-platform apps and libraries”.
Order of execution (per brief §6 priority)
W1 → W3 → W2 → W4 → W5 → W6 → W7 → W8 → (W10 folded in along the way) → W9 last (external, needs DrawBox repo). W0 (publish a post) is not a code task.