How this website is designed with Claude Code

At ClaroSi, pages are planned, built and checked with Claude Code, an AI coding assistant that works in the terminal. Follow the little build guide through the five steps we use to turn a plain brief into a fast, clear landing page.

Walk the build, one step at a time

Pick a platform and the guide walks there. Each stop is one step of how a ClaroSi page goes from a sentence to a live page. Click the guide to make it jump.

Step 01 · Brief

Start with a plain-English brief

Claude Code works inside the website's own folder, so the brief can point at real files instead of describing a style from memory.

  • Say who the page is for and the one action it should lead to.
  • Name the files that hold the look: home.css, site-skin.css, ai.css.
  • Ask for a plan first, then approve it before anything is built.

Step 02 · Design system

Reuse the look the site already has

Every new page starts from the same colours and type as the rest of ClaroSi. Claude Code reads them from the stylesheets, so nothing is invented.

  • Anton for headings, Satoshi for reading text.
  • Ink, cobalt and cyan from the site; clay from Claude Code for this page only.
  • Contrast checked so small text stays readable.
INK
#0A1838
COBALT
#0D47C9
CYAN
#38D0FF
TINT
#EEF3FB
CLAY
#D97757
AaAnton
Headings, uppercase
AaSatoshi
Body, 17 to 20 px

Step 03 · Layout

Sketch the sections, then fill them

A landing page is a short story in blocks. We agree the order of the blocks first, then write the words, then style them.

  • One idea per section, with a clear heading.
  • Proof near the top, the next step at the bottom.
  • Every layout is designed for a phone as well as a desktop.

Step 04 · Check

Test it in a real browser first

Before anyone sees a change, Claude Code opens the page, reads the console and measures what it downloads. On the homepage that check found the biggest file was the animation, and it was made lighter with the same look.

  • Phone width, tablet and desktop.
  • Console errors and broken links.
  • Page weight, measured before and after.

Homepage animation, before951 KB

After re-encoding438 KB

  • Same 16-second loop and timing
  • Frames compared side by side
  • Committed only after the check passed

Step 05 · Ship

Commit, preview, then publish

Each change is saved with a note on what changed and why, shown on a private preview link, and only goes live when a person says yes.

  • Work happens on its own branch, never straight on the live site.
  • A preview link to review on a phone.
  • Publishing is a human decision, every time.
  1. 01Local branchChanges and a written commit note
  2. 02GitHubThe shared history of the site
  3. 03Vercel previewA private link to check the page
  4. 04You approveThen it goes live on clarosi.ie

Pages on this site, made the same way

Pick a layout, then switch between the wireframe and the finished design. Tap a numbered pin to see what Claude Code decided at that spot.

clarosi.ie/

Homepage

Billboard hero

The homepage opens on one big promise painted onto a Dublin billboard, then three clear next steps.

1
One promise, huge type

Anton at billboard size, so the main message reads at a glance. Claude Code kept it to one idea.

Open this page Note 1 of 3

Brief Claude Code like this

The difference between a generic page and a beautiful one is mostly in the brief. This is the shape we use for every ClaroSi landing page.

landing-page brief

> Build a landing page for [PAGE TOPIC].

  Who it is for: [AUDIENCE].

  The one action: [BUTTON TEXT] → [LINK].

  Use the look in site-skin.css and

  display-font.css. Do not add new colours.

  Sections: hero, three cards, one real

  proof point, next step, footer.

  Check it at phone width and measure the

  page weight before you say it is done.

  Show me the plan first.

01
Point at real files

Naming the stylesheets keeps every page in the same family.

02
One page, one action

A single button makes every section easier to write.

03
Ask for proof, not adjectives

A measured result beats "fast" or "beautiful" in the copy.

04
Plan before build

Approving the outline first saves a round of rework.

Same animation. Half the download.

The homepage's "Connect the data" animation plays for every visitor. Claude Code re-encoded it, compared the frames, and the page now downloads less than half as much video.

Before951 KB
After438 KB · 54% smaller
Look and lengthUnchanged

Want to learn Claude Code?

I can help you get started: setting it up, writing a clear brief, and checking its work before anything goes live. Tell me what you want to build and where you are now.

Claude Code is a product of Anthropic. ClaroSi is an independent studio that uses it and is not affiliated with or endorsed by Anthropic.