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.
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.
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.
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.
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.
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.
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
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.
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.
Headline
Newsreader 400 · clamp(2rem, 4vw, 3.25rem) · lh 1.05 · ls −0.015em
Most of the work isn’t the writing.
Title
Geist 600 · 1.375rem · lh 1.25 · ls −0.01em
Connect your WordPress site
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.
Body · UI
Geist 400 · 0.9375rem · lh 1.55
Approved drafts are sent to WordPress as drafts. You publish from your own dashboard.
Label
Geist 500 · 0.8125rem · lh 1.3
Target length
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.
Underline
Emphasise one phrase in a headline.
Circle
Call out a number or a word in a product frame.
Check
Approved. Done. Drawn next to the thing it approves.
Strike
Removed by the writer or the Editing agent.
Caret
Inserted text, suggestions, a new version.
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.
- 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.
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.
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.
| Token | Light · Paper | Dark · Ink | Tailwind |
|---|---|---|---|
| --sheet | #F4F1EA | #13110E | bg-sheet · text-sheet · border-sheet |
| --paper | #FCFBF8 | #1B1815 | bg-paper · text-paper · border-paper |
| --well | #ECE7DC | #242019 | bg-well · text-well · border-well |
| --ink | #1A1712 | #F1ECE2 | bg-ink · text-ink · border-ink |
| --graphite | #615B50 | #A39B8D | bg-graphite · text-graphite · border-graphite |
| --rule | #D9D3C6 | #2F2A23 | bg-rule · text-rule · border-rule |
| --pencil | #B8371A | #EC6A47 | bg-pencil · text-pencil · border-pencil |
| --pencil-ink | #FFF7F1 | #1A0C08 | bg-pencil-ink · text-pencil-ink · border-pencil-ink |
| --wash | #F5E1D8 | #3A1F16 | bg-wash · text-wash · border-wash |
| --success | #2E6B3E | #7BC08A | bg-success · text-success · border-success |
| --warning | #8A5A00 | #E0B458 | bg-warning · text-warning · border-warning |
| --danger | #97231C | #F08A7A | bg-danger · text-danger · border-danger |
| --lift | 0 1px 0 rgb(26 23 18/.05), 0 12px 32px -20px rgb(26 23 18/.25) · dark alpha .5 | shadow-[var(--lift)] | |
| --ds-serif | Newsreader, Georgia, serif | .ds-serif | |
| --ds-sans | Geist, system-ui, sans-serif | .ds-sans | |
| --ds-mono | Geist 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.
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.
02Fonts
Newsreader (display + prose, opsz axis), Geist (UI), Geist Mono (meta). Remove Inter Tight and Instrument Serif.
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.
04Sections
Glass → paper. Tilt → none. Section blobs → none. Pipeline packet stays (pencil). Word-mask headlines stay, in Newsreader. Beam border → 1px pencil rule.
05App
Dashboard, drafts and settings inherit the tokens unchanged. Status badges already map to the states above.