@oak-academy/oak-components v0.0.26
Oak Components
Overview
This is a React Typescript components library which supports React and Next applications produced by Oak National Academy. A storybook for the components can be found here please consult OnePassword for access.
Usage
TODO: Instructions for how to add Oak Components to a React App
Install for development
- Copy the example env config
cp .env.example .env
- Ask a colleague for the values to populate
.env
- run
nvm use
- run
npm install
- To view the storybook run
npm run storybook
Structure
Components are organised into a three tier hierarchical structure applying the following rules:
Base components
- Imports from other base components
- Imports from Ui and Integrated components are forbidden!
- Generic
- Unstyled
- Avoid embedded logic and state
- No sub-components (eg. Box)
Ui components
- Imports from base components and Ui components
- Imports from Integrated components are forbidden!
- Generic
- Styled
- Avoid embedded logic and state
- No sub-components (eg. IconButton)
Integrated components
- Imports from base components, Ui components and occasionally Integrated components
- Combines multiple Ui components together
- Applicable to a limited range of contexts which might occur in multiple apps
- Styled
- May contain embedded logic or state
May be split into sub-components (eg. SchoolInputForm)
NB. these rules are a work in progress. Modifications may be required as the library builds.
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
4 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago