Working on your project
(Ensure you have first set up your project.)
Your project is a monorepo managed via pnpm. You can build multiple packages from this one repository. Packages come in the following varieties:
- Applications (found in
[apps/]) - Libraries (found in
[lib/]) - Components (found in
[components/])
Note: If you would like add more varieties you can do so by modifying
your [pnpm-workspaces.yaml] and [plopfile.js].
Getting started
In order to work on this repository you will need to install pnpm.
Once you have it installed you can pull down NPM dependencies for the entire project by running:
pnpm install
Creating a new package
To create a new package, simply run:
npm run create
This is all orchestrated from your [plopfile.js] so you can modify how
it works.
See: PLOP
Installing your packages
You will often need to install the libraries and components that you create into each other or into your applications. This can be done just as you would install any other package:
pnpm install @{{{ dashCase name }}}/your-new-package
Under the hood, this will create a symlink so you need not worry about updates. This helps when working on mutliple packages at the same time.
Your documentation
Your project comes with its own documentation application to allow you to easily document your project, including any components that you create.
You can run it as you would any other application in your project:
cd apps/docs
npm run dev
We advise that you set up CI publish your documentation site when
pushing to the master branch.
Continuous Integration
You project comes with configuration files for running Continuous
Integration (CI) via GitHub Actions. These files are found in the
[.github/workflows] directory.
If you add the required secrets to your GitHub repository, it is also possible to quickly set up Continuous Deployment (CD) for your documentation to Netlify.