Skip to main content

Introduction

These are the apps that ship with the Blueprint repo:

Foundation App​

The Foundation app is the primary reference implementation for Blueprint. It provides a minimal but complete consumer site with internationalization, authentication, and example pages. Out of the box, it uses Radix UI components, but 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:

Note: Unlike the legacy apps (GB/FR/demo-site), the Foundation app does not include Coral, Storyblok, or pre-built marketing pages. This allows clients to choose their own UI frameworks and CMS solutions.

Storybook​

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

You can start Storybook locally by running the following:

cd apps/storybook
pnpm dev

Legacy Apps​

The following apps are legacy and being phased out in favor of the Foundation app:

  • gb-energy-consumer-site (British Energy consumer site)
  • fr-energy-consumer-site (French Energy consumer site)
  • demo-site

These apps remain in the codebase temporarily but should not be used as reference implementations for new projects.

Documentation​

This is a meta app where we document everything about Blueprint and it's apps. You're reading it right now. This can evolve into project documentation for projects that start from Blueprint.

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

cd apps/docs
pnpm start