For quick browser-based development, open this project in Gitpod. It will automatically build an environment and run Storybook.

Outline Design System

Outline is a web component based design system starter kit. Outline is based on the latest technologies and tools to help your component authoring experience and facilitate adoption in your organization.

Outline is built with the following tools:

• Lit
• TypeScript
• CSS Custom Properties (CSS Vars)
• Tailwind CSS (Optional)
• Tailwind JIT Compiler
• Storybook
• Rollup

Contributing to Outline

Information regarding how to contribute to Outline development, can be found in CONTRIBUTING.md.

Local Setup

Run the following steps to ensure your environment is installed and up to date. This assumes you are using NVM locally to manage your NPM version(s).

Checkout the repository

git clone [email protected]:phase2/outline.git && cd outline

Ensure you are using the correct version of npm

nvm use

If you need to update your node version, see the usage documentation for nvm.

Install project dependencies

yarn install

Storybook Development

Primary component development is done and demonstrated via Storybook.

Start storybook instance.

yarn start

Production builds

Runs both tsc and yarn rollup to handle the following:

• Packaging individual components to dist directory.
• Packaging modern and legacy builds of all components to dist directory.

yarn build

To only run the rollup build, which handles the component bundling into modern and legacy builds:

One time build

yarn rollup

Enable in watch mode

yarn rollup.watch

Resetting local environment

The following commands help clean a local environment.

• Cleanup generated assets: yarn clean
• Cleanup node packages: yarn reset
• Full cleanup & restart: yarn reboot