llms.txt
Compare with other sites' llms.txt files →# Vertically Works
> An open-source design system for vertical writing in Korean, Japanese and Chinese: React components built on true `writing-mode: vertical-rl`, the vertical typography rules they follow, a shadcn-compatible registry, and live apps that use them.
Vertically Works asks one question: if digital interfaces had been invented around vertical writing systems, what would software look like today? Each component page states the design question it answers and the decision taken, shows an interactive demo with its code, lists what to do and what not to do, gives accessibility notes, and ends on the question still open. Components are MIT-licensed source with no runtime dependencies: `npx verticallyworks init` installs the design tokens, then `npx verticallyworks add <name>` copies a component into your project (or `npx shadcn add https://vertically.works/r/<name>.json`).
## Docs
- [Components](https://vertically.works/components): the component system for vertical writing interfaces: real writing-mode primitives, accessible by default, source you own
- [Set up](https://vertically.works/components/setup): install the tokens, then one component at a time, with npx verticallyworks
- [Principles](https://vertically.works/principles): patterns derived from building real interfaces on the vertical axis
- [Challenges](https://vertically.works/challenges): open design problems with no obvious answer when the reading axis changes
- [Playground](https://vertically.works/playground): a live previewer across writing direction, language, theme and device
- [Resources](https://vertically.works/resources): research papers, references and links for vertical interface design
## Components
- [Button](https://vertically.works/components/button): Trigger an immediate action. In a vertical interface, label and icon orientation must match the reading axis. Install: `npx verticallyworks add vertical-button`
- [Icon Button](https://vertically.works/components/icon-button): An action triggered by an icon alone. Requires extra care for accessibility and hit targets in a vertical layout.
- [Toggle](https://vertically.works/components/toggle): A pressable element that switches between two states · on and off. Install: `npx verticallyworks add toggle`
- [Text Field](https://vertically.works/components/text-field): Single-line text input with CJK IME composition support in a vertical interface. Install: `npx verticallyworks add text-field`
- [Search](https://vertically.works/components/search): Full-text search with CJK IME composition, results list, and navigation to match.
- [Slider](https://vertically.works/components/slider): A drag control for selecting a value along a continuous range.
- [Tabs](https://vertically.works/components/tabs): Switch between related content panels. Horizontal tabs remain common even in vertical reading contexts. Install: `npx verticallyworks add tabs`
- [Verse](https://vertically.works/components/verse): The atomic unit of vertical scripture layout · a selectable, highlightable text cell within a vertical column.
- [Popover Menu](https://vertically.works/components/popover-menu): A dark vertical popover that opens from a trigger, offering highlight color swatches and action items with vertical Korean labels. Scales in from its trigger origin, collapses on close.
- [Hyperlink Treatment](https://vertically.works/components/hyperlink-treatment): Marking an inline run of text as a link without an underline.
- [Tooltip](https://vertically.works/components/tooltip): Reveal supplementary information on hover or focus without navigating away. Install: `npx verticallyworks add tooltip`
- [Sheet](https://vertically.works/components/sheet): A secondary surface that animates over primary content from a specific edge. Install: `npx verticallyworks add sheet`
- [Dialog](https://vertically.works/components/dialog): A modal window requiring user decision before proceeding. Install: `npx verticallyworks add dialog`
- [Marker](https://vertically.works/components/marker): An inline status, system note, or labeled separator in a conversation or reading thread.
- [Message](https://vertically.works/components/message): A chat message with avatar, content, timestamp, and alignment. The open question in a vertical interface is whether bubbles should adapt to the reading axis.
- [Streaming Text](https://vertically.works/components/streaming-text): A model reply that types itself. The stream fills a column downward, then wraps into a new column leftward · the answer advances across the page, not down it.
- [Thinking Trace](https://vertically.works/components/thinking-trace): An agent's reasoning as a live disclosure. The spine column summarizes; steps unfold beside it along the reading direction, the running step always at the left edge.
- [Prompt Bar](https://vertically.works/components/prompt-bar): The composer for an AI thread: a full-height column at the reading start. What you type stands where your sent turn will appear · the thread peels leftward from it.
- [Approval Card](https://vertically.works/components/approval-card): A human-in-the-loop question from the agent. Options stand as columns in reading order beside the question · approve, and the card contracts to a one-column receipt.
- [Toast](https://vertically.works/components/toast): A brief, auto-dismissing notification that doesn't interrupt the reading experience.
- [Skeleton](https://vertically.works/components/skeleton): A vertical-column shimmer that mirrors real reader metrics while content loads.
- [Vertical List Cell](https://vertically.works/components/vertical-list-cell): The primitive behind every vertical list. A row cell rotated onto the vertical axis: a full-height column with a leading edge at the top, vertical title/subtitle, and a trailing accessory at the bottom. Install: `npx verticallyworks add vertical-list-cell`
- [Column Accordion](https://vertically.works/components/column-accordion): A disclosure list on the vertical axis. Each item is a collapsed title column; opening one widens it sideways, unfolding its detail as new columns beside the title along the reading direction. Install: `npx verticallyworks add column-accordion`
- [Tiered Page](https://vertically.works/components/tiered-page): A static book page of vertical columns split into two stacked tiers · the vertical answer to the two-column spread. With a verse-number band, or as a plain two-row layout divided by rules. Install: `npx verticallyworks add tiered-page`
## Rules and registry
- [Vertical typography and punctuation rules](https://vertically.works/components/typography): glyph orientation, tate-chu-yoko digits, punctuation verticalization and 금칙/kinsoku (禁則) line breaking, following KLREQ, JLREQ and UAX #50. Install: `npx verticallyworks add vertical-typography`
- [Registry index](https://vertically.works/r/index.json): every installable item with its title and description
- [shadcn registry](https://vertically.works/r/registry.json): the same items in shadcn registry format
- [Full text](https://vertically.works/llms-full.txt): every component page and the typography rules in one file
## Applications
- [Vertically Verse](https://vertically.works/apps/verse): a fully vertical, right-to-left scripture reader for Korean, Japanese and Chinese, on iOS and on the web at verse.vertically.works
- [Vertically Shelf](https://vertically.works/apps/shelf): an iOS reader for East Asian classics set fully vertical, right to left; in public beta on TestFlight
- [Vertically News](https://vertically.works/apps/news): a daily reader that sets live Korean, Japanese and Chinese headlines as a vertical, right-to-left front page, at news.vertically.works
- [Vertically To-do](https://vertically.works/apps/todo): a to-do list where tasks are columns you read top to bottom, at todo.vertically.works
- [Vertically Chat](https://vertically.works/apps/chat): an AI chat interface where turns are columns and the thread flows right to left, at chat.vertically.works
- [Vertically Stitch](https://vertically.works/apps/stitch): a study of entrance and exit motion for embroidered vertical text: letters sewn strand by strand on a canvas, then unpicked the way they came, at stitch.vertically.works
## About
- [About](https://vertically.works/about): who builds Vertically Works and why (Jihoon Suh)
- [Source](https://github.com/jihoons0/vertically-works): the design system, registry, spec and CLI, MIT-licensed
- Cite as: Vertically Works, https://vertically.works