TL;DR
Typscool is a browser-based typography system generator. You set a base font size and scale ratio, and it calculates a six-level heading hierarchy plus three body text sizes for desktop, tablet, and mobile. It checks WCAG contrast live, previews text inside real page templates, and exports a production-ready CSS file with variables, classes, and responsive media queries.
What problem does Typscool solve?
Typography is one of the most repetitive and most frequently mismatched parts of a design-to-development handoff. Designers and developers each run into a different version of the same gap.
Problems on the design side
- Design tools like Figma and Sketch don't render type the way a browser does, so designers are left guessing how text will actually look on real screens.
- Building a heading and body hierarchy from scratch means manually testing sizes, ratios, and spacing until something feels right.
- That entire process then has to be repeated for desktop, tablet, and mobile breakpoints.
- Handoff documentation describing all of this is rarely written down, and is often the first thing skipped under deadline pressure.
- Contrast and readability checks usually require a separate external tool, so accessibility becomes an afterthought rather than part of the process.
Problems on the development side
- Mockups often arrive without the underlying typography logic, forcing developers to extract sizes, weights, and spacing layer-by-layer.
- Text styles end up scattered across pages with no single reference describing the scale that was used.
- Small manual tweaks during design cause the same heading to look slightly different from page to page.
- Even with a framework like Tailwind, developers still need a typography system in place before those classes mean anything.
- Responsive type rules for tablet and mobile are rarely documented in enough detail to implement directly.
These communication gaps, on both sides, are the core reason Typscool exists: a shared, browser-accurate source of truth for typography that both designers and developers can reference and export from.
What does Typscool actually provide?
At its core, Typscool gives you a structured environment to build, preview, and export a complete typography system, with live feedback across devices. That includes:
- Dynamic type scale generation based on the modular scale concept
- Independent configuration for desktop, tablet, and mobile breakpoints
- Real-time preview directly in the browser
- Contrast validation built into the workflow
- Full styling controls for both headings and body text
- Exportable CSS with variables and media queries
- A responsive type scale hierarchy panel for developers
How the dynamic typography scale works
Everything in Typscool is derived from two inputs: a base font size and a scale ratio. The base size is your default paragraph text size, set separately for desktop, tablet, and mobile. The scale ratio determines how each step in the hierarchy grows from that base, using common modular scale presets such as Perfect Fourth, Golden Ratio, or Major Second, or a custom value.
From those two numbers, Typscool calculates six heading levels (H1–H6) and three body variants (body-sm, body-md, body-lg), and updates every value live as you adjust the ratio or base size. This mirrors the modular scaling approach commonly used in web typography to keep hierarchy and readability consistent across a design system.
Breakpoint management
Desktop, tablet, and mobile are each configured independently, with their own base font size, scale ratio, and max-width threshold. Changing any of these values recalculates the entire system instantly, and the corresponding responsive media queries are generated automatically when you export. In practice, this removes the need to build separate artboards just to test how typography should adapt across screen sizes.
Body text controls
The body text panel covers font family (with access to the full Google Fonts library, no downloads required), font weight from 100 to 900 for variable fonts, precise line-height and letter-spacing controls down to the decimal, and both text and background colour for accurate contrast testing against your actual design.
Body text comes in three size variants. Body-md is the base size for text-heavy paragraphs, body-lg works well for supporting text paired with headings, and body-sm suits de-emphasised text such as captions or links. All of these settings apply across the entire preview and hierarchy panel at once.
Heading controls
Headings can either inherit the body typeface or use an independent font chosen from the same Google Fonts library. The same set of controls for weight, line height, letter spacing, and colour apply here too. All six heading levels (H1–H6) scale automatically from the ratio you've set, which keeps the hierarchy mathematically consistent without manual adjustment, and stays within the six-level limit that web standards and accessibility guidance recommend.
The type scale hierarchy panel
For developers, the hierarchy panel works as a live reference sheet. Every text style shows its pixel, rem, and em values along with contrast status, and values can be copied with a single click. This removes the need to manually recalculate units when translating a design into code. The full configuration can also be exported as a CSS file and linked into any project.
Accessibility and contrast checks
Typscool checks contrast ratios against WCAG formulas as you work, and surfaces one of three statuses for each text style:
- Readable — even the smallest text with the applied colours remains legible for users with visual impairments.
- Poor readability — the text may be difficult to read for some users, and risks visitors leaving the page if left unaddressed.
- Not readable — the combination should not be used.
This evaluation runs across body text contrast, heading contrast, and large-text exceptions for sizes above 18px, so accessibility stays part of the live preview rather than a separate audit step.
Preview templates and device views
Typography is previewed inside an embedded, isolated iframe using real page templates rather than blank canvases. Two templates are available: a landing page layout for seeing all text sizes in a typical marketing context, and a blog article layout for judging the full hierarchy in a reading-focused context. Each can be viewed at desktop, tablet, or mobile widths, which gives a much closer sense of real-world behaviour than most design tools allow.
Exporting CSS and documentation
When you're ready to implement, Typscool exports a complete,
production-ready CSS file containing CSS variables for fonts,
spacing, line heights, and colours; full text classes from
.h1
through
.h6
and
.body-sm/md/lg;
responsive breakpoints with tablet and mobile media queries; and an
auto-generated README documenting how to implement it. The output
is framework-agnostic and can be dropped into any project.
Interface and productivity features
The interface is built around a familiar two-panel layout, similar to Figma for designers or VS Code and Cursor for developers, with one large canvas in the centre. Both side panels can be collapsed to preview text in full screen, colour pickers update accessibility checks in real time as you change values, and number fields support scroll-to-adjust for fine-tuning.
A few keyboard shortcuts speed up the workflow considerably:
- 1 / 2 / 3 — switch device view
- 4 — toggle the left panel
- 5 — toggle the right panel
- T — switch preview template
How designers use Typscool
Designers typically reach for Typscool early in a project, before moving into Figma. A single typeface selector applies across all six heading levels, which avoids the back-and-forth of testing multiple fonts manually. From there, the full hierarchy can be previewed on real web surfaces, with pixel, rem, and em values ready to copy directly into a design system.
Because breakpoints are handled automatically, designers don't need to rebuild styles for tablet and mobile — the focus stays on applying branding to wireframes. Contrast checks happen alongside colour selection, so accessibility is addressed before handoff rather than after. The result is a system that's already documented and ready to share with developers.
How developers use Typscool
For developers, Typscool functions as a foundation layer for typography-related work. A hand-off note and exported configuration give a clear picture of the exact hierarchy before any code is written. Classes follow simple, human-readable naming (h1, h2, h3, body-sm, and so on) rather than scale-based naming like h-xl or h-2xl, so there's no guessing involved.
Responsive media queries for each breakpoint are generated automatically as part of the export, and the CSS file works well alongside frameworks like Tailwind. If feedback requires changing the base size or scale ratio later, that's a single edit to the exported file rather than adjusting every heading and body style individually.
Where Typscool fits best
Typscool is best suited for getting clarity on a typography system before starting a new project (or auditing an existing one), building new design systems, defining typography specifications for a team, pairing and previewing fonts from the Google Fonts library in real time, improving design handoff overall, ensuring WCAG-compliant text, and testing typography live inside real page layouts rather than static mockups.
Closing thoughts
Typscool centralises typography logic into one environment that both designers and developers can use, with live previews that reflect how text actually behaves in a browser. If you have questions or feedback, you can reach out at ashishbiz@pm.me.