Skip to content

About

A fictional product, built with real code.

Foundry exists to demonstrate how a production-grade component and design-system platform can be architected. The company is invented, the customers are invented and the pricing is invented — everything below the surface is not.

What this is

A frontend building-block library organised as four levels of composition. Primitives read tokens; navigation and forms arrange primitives; sections arrange those; patterns and starters arrange sections. Nothing at a higher level re-implements something from a lower one.

The catalogue holds 240 items across 6 families, built on 87 tokens in 14 groups, and it renders 109 starter routes from 10 route tables.

What this is not

  • Not a published package. There is no registry and no install command.
  • Not a backend. There is no database, CMS, authentication or payment provider.
  • Not a real company. Every name, quote, logo and figure in the content is fictional.
  • Not certified. Accessibility patterns are implemented and tested, not audited.

How it is built

Next.js with the App Router, React 19, TypeScript and Tailwind v4, plus lucide-react for icons. That is the entire dependency list. There is no state library, no styling runtime, no animation library and no component library underneath — the primitives are the bottom of the stack.

Sections are Server Components. Interactivity is scoped to small client islands, so a page assembled from nine sections ships almost no JavaScript.

Documentation from source

A build step reads the real component files from disk and generates two maps: raw source text, and a slug-to-component import map. The preview on a component page and the code below it come from the same file, so they cannot disagree — and a test regenerates the registry in memory and fails if it has drifted.

Demo limitations, stated plainly

  • · No form submits anything. Every success state says so.
  • · No payment is processed and no card is stored, in any flow.
  • · Search runs against a static index built at compile time.
  • · Starter previews are excluded from the sitemap and marked noindex.
  • · Manual screen-reader coverage is partial and still in progress.