PrismDevRelOpen the app
How-to guides: How to publish an app on GitHub Pages

Build

How to build a decision table appHow to build a policy decision appHow to build a state machine appHow to verify an app before you publish itHow to publish an app on GitHub PagesHow to give an AI agent the prism_prompt tool

// 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 steps, in order1. 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 it01Name therepositoryin thepromptrepository:OWNER/prism-NAME02Download theappprism-NAME.zip03Create therepositoryfrom thetemplate,with Pages04Clone itand removethe templateapp05Unpack theapp and pushthe workflowproves andserves itThe steps, in order1. 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 it01Name the repository in thepromptrepository: OWNER/prism-NAME02Download the appprism-NAME.zip03Create the repositoryfrom the template, with Pages04Clone itand remove the template app05Unpack the app and pushthe workflow proves and serves it
The steps, in order. 5 steps. Each section below is one of them.
The data in this figure
StepWhat happens
1. Name the repository in the promptrepository: OWNER/prism-NAME
2. Download the appprism-NAME.zip
3. Create the repositoryfrom the template, with Pages
4. Clone itand remove the template app
5. Unpack the app and pushthe 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=workflow

4. 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.feature

5. Unpack the app and push

unzip -o ../prism-NAME.zip
git add -A && git commit -m "Build the app from its prompt" && git push

Before you push

how-to guideBuildMarkdown

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.