Aydin Aliyev
EN

Bu səhifə yalnız ingilis dilindədir.Эта страница есть только на английском.

Colophon

How this site is built, the design system it runs on, and how it uses AI. The system below is the real CSS and JavaScript, running live.

How it's built

Framework
Next.js App Router, every page generated at build time. Two optional route handlers are the only server code.
Content
Git is the CMS: MDX files, validated by one Zod schema for essays and the log, with authorship and sources as fields.
Motion
GSAP (ScrollTrigger, SplitText, Flip, DrawSVG, ScrambleText) and Lenis. Page morphs use native view transitions.
The field
Raw WebGL, about 3 KB: one shader behind the home hero, drawn at dither-cell resolution over a 4.5 KB poster.
Languages
English at /, Azerbaijani at /az/, Russian at /ru/. Essays, the log and this page are English only.
Hosting
Vercel, from a public GitHub repository.

How this site uses AI

  1. I write the essays

    Anything under /writing that says “I” or takes a position is mine, sentence by sentence. I'll ask a model to check a fact, run my code or catch a clumsy paragraph, the way I'd ask a colleague to read a draft. It doesn't write them.

  2. Agents write most of my code, and I read all of it

    This site, like RentPilot, is built by Claude Code agents working from specs I write. Nothing merges until I've reviewed it, and commits an agent made say so in the history.

  3. No generated images

    Screenshots are real captures of real products. Diagrams and share images are drawn in code. If a picture here shows something, it exists.

Last reviewed 30 Sep 2026

The design system · approved 29 Sep 2026

Colour

tokens.css · light and dark follow the OS

Light

paperoklch(0.982 0.004 85) · background
surfaceoklch(0.962 0.006 80) · code, prompts, facts
1.1:1
inkoklch(0.21 0.012 60) · text
16.8:1
ink-2oklch(0.42 0.01 60) · secondary text
8.1:1
ink-3oklch(0.52 0.008 60) · labels, meta
5.2:1
lineoklch(0.885 0.006 75) · hairlines
1.3:1
vermilionoklch(0.58 0.19 33) · proof only
4.5:1
focusoklch(0.5 0.2 33) · focus ring
6.3:1

Dark

paperoklch(0.17 0.008 60) · background
surfaceoklch(0.205 0.008 60) · code, prompts, facts
1.1:1
inkoklch(0.93 0.006 80) · text
15.5:1
ink-2oklch(0.76 0.006 80) · secondary text
8.9:1
ink-3oklch(0.63 0.006 80) · labels, meta
5.5:1
lineoklch(0.31 0.008 60) · hairlines
1.4:1
vermilionoklch(0.7 0.17 35) · proof only
6.7:1
focusoklch(0.74 0.16 35) · focus ring
7.8:1

Contrast is computed from tokens.css when the site is built, against paper. Vermilion is reserved for proof: the Trace line, receipts and focus. It is never a button fill or a heading colour.

Type

Roboto Serif (opsz auto, wght, GRAD) + JetBrains Mono · SIL OFL 1.1

Display · 42 → 97px · 300Aydin Aliyev
H1 page · 35 → 74px · 300A car-rental marketplace, built by one engineer
H2 · 30 → 46px · 350Ten years, from React to agent teams
H3 · 22 → 27px · 400Teaching Strategies
Lede · 18 → 21pxSenior full-stack engineer in Baku. I build with a team of coding agents; nothing merges until it passes a gate I own.
Body · 17 → 19px

RentPilot connects travellers in Baku with verified rental companies. I built it alone: Claude Code agents work from specs in isolated worktrees, and every change passes a review gate I own. Italic for emphasis, never a second family.

Mono label · 13pxRentPilot · Solo build · 2026
Caps (lang="az")işlər · istinadlar · ilham · ılıq
Numbers2016 to 2019 · 1,190 commits · 41 policies · 21 specs
Long words: a size step per language
Ten years, from React to agent teamsOn il: React-dən agent komandalarınaДесять лет: от React до команд агентов

AZ headings (xl and up) run at 94% size, RU at 92% (--lang-scale). I dropped the width axis: it cost 336 KB of font on every EN page.

Weight (GRAD)
Hover: GRAD 0 → 100GRAD 100Same widths: a hover never reflows the line.

Space, grid and radii

4px base · 12 columns from 768px, 4 below · 16px phone gutter

1 · 4px
2 · 8px
3 · 12px
4 · 16px
6 · 24px
8 · 32px
12 · 48px
16 · 64px
24 · 96px

Section rhythm: --space-section = clamp(4rem … 8rem)

12 columns · gutter 24px · margin 48px (resize to see 4 columns)4 columns · gutter 16px · margin 16px

Radii: 2px on everything; the site stays square.

Motion tokens

read from tokens.css, the same values GSAP uses

TechniqueWhereTimingReduced motionMobile
RiseH1/H2, case headings, post summary0.8s expo.out, stagger 0.06sno split; 150ms fade from 0.1 on screen at loadstagger 0.04s
Travelcard → case H1, post → postexit 150ms · enter 210ms · move 400ms0scrossfade if the card is off-screen
Setsection words, timeline yearsscrub 0.5staticoff < 768px
Weightnav, inline links, active year180ms GRAD 0 → 100instanttap or focus only
Tracetimeline spine, diagrams, /pipelinelinear (none), scroll-linkedfully drawnhalf the scroll distance
Resolvestatus chip, index numbers, 4040.6s, oncefinal textunchanged
Pulltwo buttons0.4s power3.out, 0.3 of offsetoffoff without a fine pointer
Flip filter/work filters0.3s power3.outinstantsame; keyboard instant
Clip revealcase images below the fold0.9s expo.outnonesame
UI feedbackbuttons, menu, copy120ms to 300ms max0ssame

Header, language and footer

container queries: the same header renders the phone layout in the frame

Header at desktop: the live one at the top of this page. Phone (375px), menu open:

Aydin Aliyev

Pointer open: 200ms clip. Keyboard open: instant, focus moves to the first link, Esc closes and returns focus to the button.

Language switcher states

Current page in EN; links go to /az/… and /ru/… of the same page.
An EN-only page (an essay): the missing language is shown and struck, never a dead link.

Language hint (browser prefers AZ or RU, page is EN): shown once, dismissible, never a redirect

Bu sayt Azərbaycan dilində də var.Azərbaycanca oxu

Footer: the live one at the bottom of this page (jump)

Controls and labels

≤ 300ms feedback, nothing animates from the keyboard, focus always visible

Buttons: default · hover · focus-visible · pressed · disabled

Links

Status chip (from /now; Resolve plays once) · tags

Open to one audit or build at a time

Booked until December

Receipt · facts panel

Evidence: git history, checked 27 Sep 2026

Project
RentPilot
Role
Founder and sole engineer
Year
2026
Status
Live
Checked
git log, 27 Sep 2026

The facts panel is the receipt for a case study.

Cards and lists

headline = outcome, never the stack

Case-study card (home, /work)

/work index: filters re-lay the grid with Flip (keyboard: instant)

Showing 6 of 6

/work/archive table row

All projects
YearProjectRoleStackLink
2026RentPilotFounder and sole engineerNext.js, NestJS, GraphQL, Postgresrentit.mobi
2026RedesignAISenior engineer and product owner, ALB Group teamNext.js, worker, Prisma, Redisredesignai.co
2026Ta'beerCo-owner, engineerExpo, NestJS, Claude, PostgresLaunching

Writing blocks

code, prompts and model output look different on purpose

rls_tenant_isolation.sql · simplified from RentPilot
-- The app connects as a role that cannot bypass RLS.
CREATE ROLE rentpilot_app NOLOGIN NOBYPASSRLS;
 
ALTER TABLE "Booking" ENABLE ROW LEVEL SECURITY;
ALTER TABLE "Booking" FORCE ROW LEVEL SECURITY;
CREATE POLICY tenant_isolation ON "Booking"
  USING ("tenantId" = current_setting('app.tenant_id', true));
Prompt · v14 · claude-haiku-4-5 · temperature 0illustrative
Interpret the dream using ONLY the entries below. Cite every entry you use by its id. If none apply, say so. Entries: {retrieved_entries} Dream: {dream_text}
Model output · claude-haiku-4-5not edited

Water that is calm and clear points to relief after worry (entry D‑112). None of the retrieved entries speak to the house in the dream, so I have left it out.

Checked in code: cites 1 of 1 retrieved entries · forbidden-lexicon gate passed

Workflow diagram (drawn by Trace in the RentPilot case study)

Spec9 agents · isolated worktreesGatemy reviewProduction

Motion, live

left: the page's real conditions · right: forced reduced motion · Replay re-runs both

Rise

SplitText lines + mask · yPercent 110 → 0 · 0.8s expo.out · stagger 0.06 (0.04 mobile)

Full

Aydin Aliyev builds AI products and audits the code AI writes.

Reduced: no split, 150ms fade from 0.1

Aydin Aliyev builds AI products and audits the code AI writes.

Where: every H1/H2, case-study headings, post summaries. The home H1 plays once per session.

Resolve

ScrambleText 0.6s once · alphabet of the page language · final text for screen readers

Full

Booked until December

1,190 commits

Reduced: final text, no scramble

Booked until December

1,190 commits

Where: status chip, index numbers, metric chips, 404. Never the H1 or body copy.

Weight

font-variation-settings GRAD 0 → 100 · 180ms · CSS only · widths never change

Full: hover (keyboard focus applies instantly)

Reduced: same state change, instant

Where: nav, inline links, the active timeline year. Mobile: on tap and focus only.

Pull

gsap.quickTo x/y · 0.4s power3 · 30% of the pointer offset within 72px · two buttons max

Full: move the pointer near it

Reduced: off

Where: "Work with me" and "Download résumé" only. Off without a fine pointer (phones, tablets).

Flip filter

Flip.getState → change → Flip.from · 0.3s power3.out · absolute

Full

  • RentPilot
  • Ta'beer
  • RedesignAI
  • GovID
  • Drydock
  • Al-Sarraf

Reduced (and keyboard): instant

  • RentPilot
  • Ta'beer
  • RedesignAI
  • GovID
  • Drydock
  • Al-Sarraf

Where: /work filters. A UI response, so it stays at 300ms.

Clip reveal

clip-path inset(100% 0 0 0) → inset(0) · 0.9s expo.out · on enter, once

Full

Reduced: none

Where: case-study images below the fold. Never the first large image (it is the LCP candidate).

Set

ScrollTrigger scrub 0.5 on xPercent · scroll this card through the viewport

Full

Work

Reduced: static

Work

Where: section words and timeline years. Off below 768px.

Trace

DrawSVG tied to scroll · linear · the case-study diagram pins with labels in production

Full: scroll

Reduced: drawn

Where: the timeline spine, case-study diagrams, /pipeline stages. Mobile: half the scroll distance.

Travel

cross-document View Transition · exit 150 · enter 210 · move 400ms · one snapshot for text

Full: click, then use Back

Case study
RentPilot

Reduced: no transition, the page just changes

Case study
RentPilot

Where: card → case-study H1, post title → post H1. Firefox (no cross-document VT yet): 210ms fade-in from 0.1.

The field (the one WebGL moment)

raw WebGL · dithered flow field at 3px-cell resolution · 30fps · poster underneath

Full: canvas fades in over the poster (move the pointer over it)

Reduced: poster only, WebGL never downloads

Where: home hero only.

Budgets

Lighthouse
Performance 90 or more on mobile
LCP
Under 2.5 s. The headline is the largest paint and never starts hidden.
CLS
Under 0.1. Headings split into lines only after the font has loaded.
JavaScript
Under 250 KB gzipped on first load. GSAP core, ScrollTrigger, SplitText and Lenis come to about 55 KB; everything else loads per page.
Fonts
Roboto Serif without its width axis: 101 KB on English pages instead of 560 KB.
Motion
Interface feedback under 300 ms. Nothing animates when you use the keyboard, and reduced motion is honoured everywhere.

Credits and licences

Type
Roboto Serif by Commercial Type for Google, and JetBrains Mono by JetBrains. Both under the SIL Open Font License 1.1.
Libraries
GSAP by GreenSock (free, standard licence), Lenis by darkroom.engineering (MIT).
Ideas
The dithering follows Maxime Heckel's writing on Bayer dithering. The AI policy follows Simon Willison's tools colophon.
Notices
The licence texts of the code, fonts and shader this site serves, written at each build: third-party notices.