Our internal UI library.
npm install @artilleryio/alpha-centauri-componentsSimple, extensible and reusable UI components.
You may wonder why this lives as a dependency of Control Panel and not it's own standalone repo. The main reasoning is, we're iterating Alpha Centauri through Control Panel. Control Panel is the main front end focus of Artillery, so the look and feel of it dictates the rest of our front end apps or products (e.g. the website).
This is an ever evolving library that we aim to maintain with regularity.
npm run dev from root, a new build of Alpha Centauri is generated. Each time you make a change to a component with the Alpha Centauri package a new build generates.If you are using this library outside of the Control Panel monorepo, you simply run:
```
npm install @artilleryio/alpha-centauri-components
Your external project will also require the Artillery Tailwind config:
``
npm install @artilleryio/tailwind-config --save-dev
When you've decided to merge to main, GitHub expects the commit to begin with the follow:
``
ci: release v2.0.0-beta.3 @artilleryio/alpha-centauri-components
Basically, GitHub Actions listen for a change in package.json and wait for us to declare it via a commit.
If you are using Alpha Centauri in an external project you will then have to update to the latest version:
``
npm install @artilleryio/alpha-centauri-components@latest
`
import { Text } from '@artilleryio/alpha-centauri-components';
...
`
Please mark your PR with a title like so:
``
feat|fix|chore(alpha-centauri): my change
tag.Often we'll add or modify things via feature work. For example, if we are working on the Saved Views feature and this introduces a new
, we would do that as a part of the Saved Views project.Caveat - For Next's transpile option to work, for whatever reason in the
package.json of this app we had to set our types to ./src/index.ts. This is not typically standard as you would set it to wherever your generated types are defined, but this work around seems to get everything working as intended.Dependencies
Alpha Centauri is built upon simple technologies. We use generic React for components, so there are no library specific hooks or features. For example, we do not use componentise Next Link or Next Image here due to it being very Next.js specific.Here are some of the libraries that help make Alpha Centauri happen:
- TailwindCSS
- Radix UI
- Radix Colors
- Headless UI
- Tabler Icons
- Tsup
To do
There are still things to do when it comes to making Alpha Centauri "complete".- [x] Move over from standalone repo to Control Panel monorepo.
- [x] Move away from old Theme package to the new
tailwind-config` package.✨🪐