Skip to content

Latest commit

 

History

History
31 lines (22 loc) · 1.72 KB

CONTRIBUTING.md

File metadata and controls

31 lines (22 loc) · 1.72 KB

Contributing

Contributions and discussions are always welcome, no matter how large or small.

Statamic Peak is a mono repo containing the kit that gets installed for users, a development environment and the docs.

Repo structure

Location Purpose
/ The root level contains the actual kit that gets installed by Statamic.
/docs/ The documentation auto deployed to peak.1902.studio running on Netlify.
/dev/ The actual development environment. A running Statamic Peak instance.

Development environment

If you want to contribute to the core Starter Kit make sure you update the files in the dev folder of the repository. After making changes please run a local starter kit install from this folder to check everything installs properly.

When you use valet you can navigate to the dev folder and type: valet link statamic-peak. After this your site will be available on http://statamic-peak.test (or whatever you configured for your TLD).

Test the kit export

You can test the kit export by running php please starter-kit:export .././ in the dev environment. After running this command the git status should reflect all changed and new files in the root of the repo. Please don't commit those kit export changes. Exporting the starter kit, maintaining the changelog and taggin releases is something the maintainer(s) of the project do.

Docs

The documentation run on https://vuepress.vuejs.org. To locally install this navigate to the docs dir in this repo and:

  1. npm i
  2. npm run docs:dev
  3. Visit http://localhost:8080.

Commits to these docs are automatically deployed to production on https://peak.1902.studio using Netlify.