Local development requires Lando.
# Clone the site
git clone [email protected]:kalabox/kalabox.io.git
cd kalabox.io
lando start
- If you are getting a WSOD while trying to load the site in Lando check out this issue.
The project follows the normal Vuepress structure but the most important things are in the docs
directory and are non-exhaustively detailed below:
./
|-- docs
|-- .vuepress
|-- components
|-- Kalabox.vue This is basically all you need
|-- public
|-- styles
|-- overrides.css You can put site-wide css overrides here
|- styles
|-- pallete.styl Stylus constant overrides
|-- index.styl Extra styles
|-- config.js Vuepress config file
|-- enhanceApp.js App level customization
|-- README.md This contains metadata for Kalabox.vue
lando lint
lando test
Using GitHub Flow push a branch to this project and open a pull request. If tests pass and the pull request is accepted the change is automatically deployed.
git checkout -b ISSUESNUMBER-ISSUEDESCRIPITON
git add -A
git commit -m "#ISSUENUMBER: COMMIT DESCRIPTION"
lando push origin ISSUESNUMBER-ISSUEDESCRIPITON