Skip to content
SastrasAISastrasAI

Sastras AI · Design system · v1

The editor’s desk.

Sastras AI is a writing companion that learns a writer’s own voice and never publishes without their approval. The interface should feel like a good editor’s desk: warm paper, clear ink, and one pencil used sparingly to mark what matters. This document is the source of truth for colour, type, layout, marks, motion and components across the website and the app.

Status
Proposed. Not yet applied to the live site.
Themes
Light (Paper) and Dark (Ink). Same tokens, different values.
Stack
Next.js 16 · Tailwind 4 tokens via CSS variables · GSAP

01

Principles

Six rules that decide every visual call. When two options look equally good, the one that follows more of these wins.

  1. 01

    The writer stays the author

    Every screen makes the human decision visible. AI output is a proposal on the desk, never a finished thing. Approve is the only accent-coloured action.

  2. 02

    Paper before pixels

    Warm paper, ink, one pencil. Surfaces are flat and quiet so the writing and the product are what you look at. No glass, no glow, no gradients.

  3. 03

    Show the product, not a metaphor

    Visuals are real product frames built from real sample data: the draft, the agent notes, the style profile. If a picture could not exist in the app, it does not exist on the site.

  4. 04

    One pencil per view

    The accent is a mark, not a paint bucket. Each view earns one pencil moment: an underline, a check, a live dot, an Approve button.

  5. 05

    Motion with a reason

    Things move because something happened: a note arrived, a step completed, a section came into view. One signature moment per section. Everything respects reduced motion.

  6. 06

    Say only what is true

    Early access, WordPress only, three free drafts. No invented testimonials, no fake counters, no “10× faster”. Numbers appear only when they come from the docs or the product.

02

Concept

Śāstra is a body of learning written down and handed on. The product learns from what a writer has already written, and hands back a draft for them to mark up.

What the metaphor gives us

  • Sheet and paper — a warm page background and slightly brighter surfaces on top of it. Depth comes from stacking paper, not from blur.
  • Ink — text and the primary action. Confident, warm black; never pure.
  • The pencil — a single vermilion for the editor’s marks: underlines, checks, the live dot, and the one button that means “yes, publish this”.
  • Marginalia — agent notes live in the margin, in mono, like a copy-editor’s comments.
  • Proofs — product visuals are framed like a proof: a title bar, a rule, the content.

What it rules out

  • The generic AI-startup kit: blue-to-violet gradients, glass panels, glowing blobs, tilted cards.
  • Cold neutrals. Slate, zinc and pure greys read as software; the desk is warm.
  • Decoration that could belong to any product. If a shape does not come from paper, ink or a pencil, it is not ours.
  • Two accents. One pencil. Semantic colours exist for states, never for emphasis.

Margin note

The earlier token names were already right: sheet, paper, ink, graphite, rule, pencil, wash. Only their values change.

03

Colour

Twelve tokens, two themes. Every text pair passes WCAG AA in both. Ratios shown are light / dark against the sheet.

Neutrals · the desk

  • --sheet

    Page background. The desk.

    #F4F1EA · #13110E

  • --paper

    Cards, windows, inputs. The sheet on the desk.

    #FCFBF8 · #1B1815

  • --well

    Inset areas inside paper: sidebars, sample blocks.

    #ECE7DC · #242019

  • --ink

    AA 15.8 / 16.0

    Primary text, primary buttons.

    #1A1712 · #F1ECE2

  • --graphite

    AA 6.0 / 6.9

    Secondary text, labels, metadata.

    #615B50 · #A39B8D

  • --rule

    Hairlines, borders, dividers. 1px, always.

    #D9D3C6 · #2F2A23

The pencil

  • --pencil

    AA 5.2 / 6.0

    The editor’s pencil. Marks, links, live states, Approve.

    #B8371A · #EC6A47

  • --pencil-ink

    AA 5.5 / 6.1

    Text on pencil.

    #FFF7F1 · #1A0C08

  • --wash

    Pencil tint for selected rows, highlights, badges.

    #F5E1D8 · #3A1F16

Semantic · states only

  • --success

    AA 5.7 / 8.8

    Done, published, sent. Always with a check or a word.

    #2E6B3E · #7BC08A

  • --warning

    AA 5.3 / 9.7

    Needs attention: fewer than 10 posts, quota nearly used.

    #8A5A00 · #E0B458

  • --danger

    AA 7.2 / 7.7

    Failed runs, disconnect, delete. Outline button + icon.

    #97231C · #F08A7A

Usage rules

  • Pencil covers at most 5% of any view. Buttons are ink. Approve is the exception.
  • Wash is a tint for selection and highlight, never a background for whole sections.
  • Semantic colours always travel with a word or an icon. Colour is never the only signal.
  • Danger and pencil are both warm reds by design: destructive actions are outlined and iconed, never solid, so the two cannot be confused.
  • Dark mode is a lit desk at night: warm blacks, the same pencil lifted two steps. Not an inversion.

Pairs in practice

Ink on sheet — body text
Graphite on paper — secondary
Sheet on ink — primary button
Pencil-ink on pencil — Approve
Pencil on wash — selected, in review

04

Typography

Two families with a clear job each. Newsreader for anything a reader reads. Geist for anything a user operates. Plex Mono for the margin.

Aa

Newsreader

Display, headlines, prose. Variable, optical sizes 6–72. Italic allowed for one emphasised phrase per headline.

Aa

Geist

UI: navigation, buttons, labels, product frames, tables. Weights 400 / 500 / 600.

Aa

Geist Mono

Meta and margin: eyebrows, timestamps, counts, agent labels. Uppercase with 0.08em tracking at small sizes.

  1. Display

    Newsreader 400 · clamp(2.75rem, 6.5vw, 5.5rem) · lh 0.98 · ls −0.02em · opsz 72

    Your next post, drafted in your voice.

  2. Headline

    Newsreader 400 · clamp(2rem, 4vw, 3.25rem) · lh 1.05 · ls −0.015em

    Most of the work isn’t the writing.

  3. Title

    Geist 600 · 1.375rem · lh 1.25 · ls −0.01em

    Connect your WordPress site

  4. Body · prose

    Newsreader 400 · 1.125rem · lh 1.6 · max 68ch

    Sastras AI reads the posts already on your site, learns how you write, and drafts the next one. Nothing goes live until you say so.

  5. Body · UI

    Geist 400 · 0.9375rem · lh 1.55

    Approved drafts are sent to WordPress as drafts. You publish from your own dashboard.

  6. Label

    Geist 500 · 0.8125rem · lh 1.3

    Target length

  7. Meta

    Geist Mono 400 · 0.6875rem · ls 0.08em · uppercase

    DRAFT 01 · WAITING FOR YOUR APPROVAL

Measure
Prose 60–70 characters. UI text 45–60. Never edge-to-edge paragraphs.
Emphasis
Italic Newsreader for one phrase in a headline. Never colour the phrase; underline it with a pencil mark if it needs more.
Numbers
Tabular figures in tables, counters and prices (font-variant-numeric: tabular-nums).
Minimums
16px body on mobile. 12px is the floor for meta, and only in mono uppercase.

05

Layout & spacing

A 4px base, a 12-column grid, and generous section rhythm. Density is for the app; the website breathes.

Spacing scale · px

  • 4
  • 8
  • 12
  • 16
  • 24
  • 32
  • 48
  • 64
  • 96
  • 128
Container
max-width 80rem (1280px), gutters 20px mobile, 32px desktop
Grid
12 columns, 24px gap. Editorial splits: 4/8, 5/7, 7/5
Section
96px vertical on mobile, 128px on desktop. Sections separated by a 1px rule, not by background bands
Component
Card padding 24px. Row padding 12–16px. Inline gaps 8–12px
Breakpoints
375 · 768 · 1024 · 1440

Radius

  • sm4pxbadges, chips, small inputs
  • md8pxbuttons, inputs, list rows
  • lg12pxcards
  • xl16pxproduct windows, section panels
  • pill999pxstatus pills, the live dot

06

Surfaces

Depth is paper on paper. Three levels, one shadow, no blur.

sheet · page

paper · card, window

well · inset

Sample data, sidebars, code, quoted drafts.

Border
1px rule on every paper surface. Rules are structure; they never disappear on hover.
Shadow
--lift: 0 1px 0 rgb(26 23 18 / 0.05), 0 12px 32px -20px rgb(26 23 18 / 0.25). Dark: alpha 0.5. Used on windows and hover-raised cards only.
Texture
Optional 2% paper grain on the sheet of marketing pages (SVG noise). Never on the app, never on text.
Focus
2px pencil outline, 3px offset. Identical in both themes.

07

Pencil marks

The one decorative element. Hand-drawn strokes that draw themselves once, in 900ms, when they appear. Use one per view.

your voice

Underline

Emphasise one phrase in a headline.

3 drafts

Circle

Call out a number or a word in a product frame.

Check

Approved. Done. Drawn next to the thing it approves.

and then I

Strike

Removed by the writer or the Editing agent.

Caret

Inserted text, suggestions, a new version.

Research · 3 posts

Bracket

A margin note that refers to a passage.

Stroke
2.25px, round caps, non-scaling. Always the pencil colour.
Draw
stroke-dashoffset 1 → 0 over 900ms, ease-out, once. Static under reduced motion.
Limit
One mark per viewport. Marks never replace a real UI state.

08

Motion

Four durations, three curves. Motion shows cause and effect: a step finishing, a note arriving, a section entering.

--dur-tap
120ms
Press feedback, toggles
--dur-state
240ms
Hover, focus, colour and border changes
--dur-reveal
480ms
Elements entering on scroll: opacity + translateY ≤ 24px
--dur-scene
900ms
The hero scene and the pencil marks. Nothing else.
--ease-out
cubic-bezier(0.2, 0.7, 0.2, 1)
Everything that enters
--ease-in
cubic-bezier(0.5, 0, 0.8, 0.4)
Everything that leaves; shorter than its entrance
--ease-scrub
linear
Scroll-linked values only

Allowed

  • Word-by-word headline reveals (masked, translateY only).
  • Reveals on scroll: opacity + ≤ 24px, staggered 60–80ms.
  • Product frames that play their real sequence: agents finishing, a draft typing, a status flipping.
  • One scroll-linked scene on the site: the hero.
  • The live dot. A pencil mark drawing itself.

Not allowed

  • Parallax on content, tilt on hover, magnetic buttons.
  • Infinite loops except the live dot and one marquee per page.
  • Anything that animates width, height, blur or filter.
  • Motion that hides content until scrolled: everything is readable with JavaScript off.
  • Ignoring prefers-reduced-motion. Reduced motion means static, not slower.

09

Components

Built from the tokens above. Rendered live here; the same classes ship in the app.

Buttons
Height
40px default, 44px on touch, 36px compact in tables
Rule
One primary per view. Approve is pencil only where it means publish-side approval.
Inputs
Card · margin note · proof frame

yourblog.com · Draft 01

How to keep your sourdough starter alive while you travel

I’ve lost two starters to holidays. Now I feed mine, put it in the fridge, and leave it alone until I’m home.

In reviewEditApprove
Eyebrow · tag · live

How it works

Later

Early access

sourdough starter

10

Product states

Draft statuses from the MVP flow: idea → generating → in review → approved → published, or rejected. One look each, in both themes.

  • GeneratingOutline rule, graphite text, live dotborder-rule text-graphite
  • In reviewPencil outline on washborder-pencil bg-wash text-pencil
  • ApprovedSolid inkborder-ink bg-ink text-sheet
  • PublishedInk outlineborder-ink text-ink
  • RejectedGraphite, struck throughborder-rule text-graphite line-through
Agents
Queued (graphite) → Running (pencil + live dot) → Done (success + check). Progress bars are pencil on rule.
Quota
Free plan meter: pencil bar; warning colour when one draft is left (2 of 3 on Free); text always says the numbers.
Errors
Danger text with an icon and a recovery step, placed next to the thing that failed.

11

Voice & copy

The interface talks like a careful editor: plain, specific, on the writer’s side.

  • Second person, present tense.

    “Sastras AI reads your sitemap.” not “Our platform leverages…”

  • Plain verbs.

    reads, learns, drafts, suggests, waits. Never empowers, unlocks, supercharges.

  • Name the limit next to the promise.

    “Three free drafts a month.” “WordPress only, for now.”

  • The writer is the subject.

    “You approve everything.” The product is the object.

  • No hype adjectives.

    Banned in copy and in the Avoid list of the sample preferences: ultimate, game-changing, revolutionary, seamless.

  • Short. One idea per sentence.

    Headlines under eight words. Body under 25 words a sentence.

12

Do / Don’t

The short version, for reviewing a screen in a minute.

  • Do
  • Paper cards with a 1px rule and a soft, warm lift shadow
  • Ink for primary buttons; pencil only for Approve, links and marks
  • Newsreader for anything a reader reads; Plex Sans for anything a user operates
  • Real product frames with sample data from lib/dummy
  • One pencil mark per view: underline, circle, check, caret
  • Reveals that move ≤ 24px and finish in under half a second
  • Warm blacks in dark mode; the same pencil, lifted for contrast
  • Don’t
  • ✕Gradient text, gradient borders, conic beams
  • ✕Glassmorphism, backdrop blur, aurora blobs, spotlights that follow the cursor
  • ✕Violet, indigo, cyan or any second accent hue
  • ✕Tilting cards, parallax on content, infinite loops other than the live dot
  • ✕Abstract illustrations or 3D renders standing in for the product
  • ✕Fake metrics, testimonials or logos
  • ✕Pure black (#000) or pure white (#FFF) anywhere

13

Token reference

CSS custom properties. Tailwind utilities read them through @theme inline, so bg-paper, text-ink and border-rule keep working everywhere.

TokenLight · PaperDark · InkTailwind
--sheet#F4F1EA#13110Ebg-sheet · text-sheet · border-sheet
--paper#FCFBF8#1B1815bg-paper · text-paper · border-paper
--well#ECE7DC#242019bg-well · text-well · border-well
--ink#1A1712#F1ECE2bg-ink · text-ink · border-ink
--graphite#615B50#A39B8Dbg-graphite · text-graphite · border-graphite
--rule#D9D3C6#2F2A23bg-rule · text-rule · border-rule
--pencil#B8371A#EC6A47bg-pencil · text-pencil · border-pencil
--pencil-ink#FFF7F1#1A0C08bg-pencil-ink · text-pencil-ink · border-pencil-ink
--wash#F5E1D8#3A1F16bg-wash · text-wash · border-wash
--success#2E6B3E#7BC08Abg-success · text-success · border-success
--warning#8A5A00#E0B458bg-warning · text-warning · border-warning
--danger#97231C#F08A7Abg-danger · text-danger · border-danger
--lift0 1px 0 rgb(26 23 18/.05), 0 12px 32px -20px rgb(26 23 18/.25) · dark alpha .5shadow-[var(--lift)]
--ds-serifNewsreader, Georgia, serif.ds-serif
--ds-sansGeist, system-ui, sans-serif.ds-sans
--ds-monoGeist Mono, ui-monospace, monospace.ds-mono

14

Applying it

What changes on the live site once this is approved. Nothing here is applied yet; this page previews the tokens on itself only.

  1. 01Tokens

    Swap the values in :root and :root[data-theme=dark]. Names stay: sheet, paper, ink, graphite, rule, pencil, wash. Add well, pencil-ink, success, warning, danger.

  2. 02Fonts

    Newsreader (display + prose, opsz axis), Geist (UI), Geist Mono (meta). Remove Inter Tight and Instrument Serif.

  3. 03Hero

    Keep the scene. Fragments become paper index cards with a rule; the gradient word becomes ink with a drawn pencil underline; blobs and spotlight go; the dot grid stays.

  4. 04Sections

    Glass → paper. Tilt → none. Section blobs → none. Pipeline packet stays (pencil). Word-mask headlines stay, in Newsreader. Beam border → 1px pencil rule.

  5. 05App

    Dashboard, drafts and settings inherit the tokens unchanged. Status badges already map to the states above.