All packages in this repository are in an early stage of development and till a solid foundation is reached the versioning will not follow semver rules
# Yarn
yarn add @cap3/capitano-components
# NPM
npm install @cap3/capitano-componentsimport {
ThemeProvider,
defaultLightTheme,
Button,
H1,
} from "@cap3/capitano-components";
// all capitano-components must reside under the context of a ThemeProvider,
// you can use the defaultLightTheme or any other theme object compatible with
// the CapitanoTheme type
const App = () => (
<ThemeProvider theme={defaultLightTheme}>
<H1>Hello World</H1>
<Button onClick={() => alert("it's alive")}>Click me</Button>
</ThemeProvider>
);Thanks for taking the time to contribute! Issues and pull requests are welcome.
To make it a little easier the following guide will help.
This project uses yarn workspaces with lerna, to install dependencies rund
yarn install in the root folder
to build all projects run yarn build in the root folder
- capitano-components
- the component collection
/srcsource code including snapshot tests/atoms- basic ui building blocks
/molecules- components built from multiple atoms
/organisms- specialized components offering more complex features
/templates- components in reoccurring patterns combined for easy usage
/pages- complete page layouts often needed
/logic- components without concrete visual implementation offering often needed functionality
/utils
/testtest setup
- capitano-theme
- theming basics, tools and theme type definitions
- capitano-scripts
- scripts and configs
- capitano-components-styleguide
- styleguide generator, based on styleguidist
- capitano-theme-generator
- generator tool to visually support theme-building
- capitano-styleguidist-components
- styleguidist override components to provide theme options
- Specify the version
- What was done?
- What is the expectation?
- What is the wanted behaviour?
MIT © Cap3