Skip to main content

Introduction

The Blueprint repo contains one app used by clients as a starter template or reference app (Foundation) and two reference apps (Docs and Storybook) for development and documentation only.

Foundation App​

The Foundation app is used by clients as a starter template or reference app — the primary, production-ready consumer site for Blueprint. Use it as a template or lift-and-shift (copy-paste) features from it. It provides a minimal but complete consumer site with internationalization, authentication, and example pages. Out of the box, it uses an abstracted UI layer (@foundation/ui) so the underlying library can be swapped. The architecture is designed to be tooling-agnostic, allowing clients to use their preferred UI library with minimal effort.

You can start the Foundation app locally by running the following:

cd apps/foundation
pnpm dev

Key features include:

For how Foundation structures features and how to copy them into your project, see Copying features into your project under Development.

Reference apps (development and documentation only)​

These apps live in the repo for reference and development. Clients use Foundation as their starter or reference; they do not use Docs or Storybook as deliverables.

Storybook​

Blueprint has a unified Storybook that showcases components, pages, and related GraphQL queries across different markets. It provides interactive examples and documentation for all Blueprint components.

cd apps/storybook && pnpm dev

Documentation​

This is the app where we document everything about Blueprint and its apps. You're reading it right now.

cd apps/docs && pnpm start