How-to guides: How to publish an app on GitHub Pages
// how-to guide · Build
How to publish an app on GitHub Pages
Give the app its own repository from the template, whose workflow proves it and serves it on GitHub Pages.
The repository is made from UOR-Foundation/template. Its Pages workflow runs the gate and publishes the app only when every claim holds.
The data in this figure
| Step | What happens |
|---|---|
| 1. Name the repository in the prompt | repository: OWNER/prism-NAME |
| 2. Download the app | prism-NAME.zip |
| 3. Create the repository | from the template, with Pages |
| 4. Clone it | and remove the template app |
| 5. Unpack the app and push | the workflow proves and serves it |
1. Name the repository in the prompt
Set repository to OWNER/prism-NAME. The schema says: owner/name of the repository the app will live in, for its page and links.
NAME is app.name in the prompt.
2. Download the app
Build the prompt in the builder and press Download .zip. The download is prism-NAME.zip.
3. Create the repository
gh repo create OWNER/prism-NAME --template UOR-Foundation/template --public
gh api -X POST repos/OWNER/prism-NAME/pages -f build_type=workflow4. Clone it
git -c core.autocrlf=false clone https://github.com/OWNER/prism-NAME.git
cd prism-NAME
git rm -q app/src/Contract.lex.tex crates/conformance/tests/contract.rs features/suites/contract.feature5. Unpack the app and push
unzip -o ../prism-NAME.zip
git add -A && git commit -m "Build the app from its prompt" && git pushBefore you push
- How to verify an app before you publish it: run the same gate on your own machine first.
Words on this page 2
- UOR
- Universal Object Reference: the UOR Foundation's framework for naming any object by its content.
- prompt
- One JSON document that describes an app. The builder turns it into every facet of a Prism model.