ai-instructions
Contents of the docs

ai-instructions · Docs

Styleguides

Twenty design styleguides for websites, from calm to playful, and how to hand them to an agent.

On this page

The folder styleguides/ holds one file per design style. A styleguide describes colours and their roles, typography, layout, components, motion and a checklist – precise enough for an agent to build a page from it without seeing a reference. The styleguides are written in German.

Overview

The previews are sample pages built from the colours, fonts and components of each styleguide. Names and contents in them are made up. Exception: Contour, Graphite, Noir, Plum and Sunset grew out of the design drafts for aspect42; their previews show those drafts in the aspect42 colours.

Civic

Civic preview: cream page with a dark red hero, uppercase serif headline and four service cards

Warm cream surfaces, serif headlines and one strong accent, calm service cards. Suits: service-oriented sites; default for new sites. File: civic.md

Bento

Bento preview: white rounded tiles on grey-green ground, petrol number, dark status tile and lime tile

Tile grid in petrol with one dark contrast tile and one lime tile, light and dark. Suits: portfolios, product pages, dashboards. File: bento.md

Blockcraft

Blockcraft preview: pixel headline in a blue sky above a row of grass blocks, inventory slots and a green XP bar below

Voxel world of sky, grass and stone blocks, pixel font, inventory and XP bar. Suits: game jams, coding courses, gaming communities. File: blockcraft.md

Blueprint

Blueprint preview: deep blue blueprint with a house drawing and yellow dimension line next to two drawing sheets with title blocks on grid paper

Grid paper, deep blue blueprints with dimension lines, drawing sheets with title blocks, pencil yellow. Suits: engineering offices, architecture, technical consulting. File: blueprint.md

Comic

Comic preview: comic panels with black borders, yellow Bangers headline, drawn figure with speech bubble and a yellow explosion star

Newsprint with halftone dots, panels in thick ink, speech bubbles and sound effects. Suits: events, offers for kids and teens, product launches. File: comic.md

Contour

Contour preview: white page with a headline in a wide grotesque, the second line in a magenta-to-orange gradient, topographic contour lines in gradient colours around a round logo mark on the right

Everything in lines on white: topographic contour lines, 1 px gradient borders, outlined numerals, colour never as a surface. Suits: agencies, design studios, brands with an outline logo or a gradient. File: contour.md

Cosmos

Cosmos preview: dark starry sky with violet nebula, headline in a white-to-cyan gradient, planet with orbits and glass cards

Deep space with stars and nebulae, gradient headline, glass cards and orbits. Suits: tech start-ups, AI and data products, astronomy. File: cosmos.md

DasRed

DasRed preview: red sky with golden rays, golden hexagon emblem above a large uppercase name, three dark red cards below

Red sky over purple night, golden rays, golden emblem and a name with stacked shadow. Suits: brands, teams, streamers with a red identity. File: dasred.md

Editorial

Editorial preview: bold serif masthead, cover story with rust red drop cap, portrait and fact box on warm paper

Magazine on warm paper: masthead, cover story with drop cap, fact box, rust red. Suits: authors, consultancies, culture, long reads. File: editorial.md

Graphite

Graphite preview: anthracite page with a light headline and an orange second line, illustration in a frame with orange corner marks

Logo anthracite as the page colour, outline wordmark as key visual, frames with orange corner marks, mono labels in brackets. Suits: development agencies, IT services, technical products. File: graphite.md

Hello World

Hello World preview: a print code line with blue cursor, large serif headline below on near-white ground

White paper, a line of code with a blinking cursor and its output below in a large serif. Suits: developer portfolios, dev tools, tech blogs. File: hello-world.md

Narf

Narf preview: handwritten name with a word circled in red on grid paper, yellow highlighter, taped photo and two sticky notes

Lab notebook on grid paper, handwriting, highlighter, red circles, taped photo and sticky notes. Suits: maker portfolios, hackspaces, side projects. File: narf.md

Noir

Noir preview: deep black page with a magenta-orange field of light, centred Bodoni headline with an italic second line

Deep black, large Bodoni with an italic counter-voice, hairlines, generated fields of light in the brand colours. Suits: ambitious agencies and studios, architecture, culture. File: noir.md

Philipp

Philipp preview: red hero with code lines, white name and portrait tile, a row of tiles below with a red number and a dark status tile

Red hero with lines of code, bold sans headline, portrait tile and a bento row below. Suits: freelancers, agencies, dev tools with a strong brand colour. File: philipp.md

Plum

Plum preview: deep plum surface with a serif headline, second line in coral italics, coral button and illustration on a light card

Plum and blush alternating, coral as the action colour on dark, Newsreader with italic accents, arched portraits. Suits: coaching, consulting, agencies, culture. File: plum.md

Retro 90s

Retro 90s preview: starfield with marquee, name in chrome lettering, planets as links, grey 3D buttons and a green hit counter

Homepage from 1996: starfield, chrome lettering, planets as navigation, grey 3D buttons, hit counter. Suits: anniversaries, retro events, fun pages. File: retro90s.md

Studio

Studio preview: huge wide uppercase headline with an orange dot, numbered service rows with black rules below, one highlighted in black

Swiss grid: huge wide capitals, black rules, numbered rows, signal orange. Suits: agencies, studios, consultancies. File: studio.md

Sunset

Sunset preview: rounded panel with a grainy magenta-to-orange gradient, white headline and white buttons, tilted illustration on a light card

Large grainy gradient panels at the start and end of every page, soft white cards in between. Suits: agencies, start-ups, apps, brands with a gradient. File: sunset.md

Superhero

Superhero preview: blue sky with sun rays and clouds, yellow and red hexagon emblem above a large name with red shadow, yellow button

Blue sky with sun rays and clouds, own emblem, name with red shadow, sun yellow. Suits: freelancers, emergency services, campaigns. File: superhero.md

Terminal

Terminal preview: dark terminal windows with green prompt, name as output of whoami, JSON with syntax highlighting and a status bar

Dark shell with windows, prompt, typed commands, syntax highlighting and a status bar. Suits: dev tools, CLIs, open source, DevOps. File: terminal.md

Structure of a styleguide

Most styleguides follow the same outline:

Section Contents
Purpose, summary what the style is for and what it looks like in one paragraph
Guiding idea the principles every decision follows
Colours and roles every colour with value and job (surface, text, action, state …)
Typography fonts, sizes, weights
Layout, components, motion grid, surfaces, typical building blocks, animations
Dos and don'ts checklist for the finished result
Tokens as CSS colour roles as CSS variables to copy
Compact prompt the style in a few sentences, ready for an agent

Civic differs: instead of tokens and a compact prompt it has a section on applying it to another project, with its own checklist.

Usage

Give the agent the whole styleguide and say what comes from the project:

Design the landing page following ~/Web/ai/styleguides/bento.md.
Keep layout, typography and components, but replace the petrol accent with our brand colour #1F6FEB.
Check the result against section "Dos und Don'ts" before you finish.

For a quick draft the "Kompakter Prompt" (compact prompt) section at the end of the file is often enough.

Important

Some styleguides draw on well-known motifs (comics, block games, superheroes). Only principles and mood are taken over, never characters, logos, crests or other protected motifs.