Getting Started

From empty folder to a Deployable colleagues can open.

1. Build a static app

Most Stackboard apps start in an AI coding assistant. Ask for a static frontend with no backend, since Stackboard serves files from your repository and can’t run a server:

Build a static React app with Vite that shows a sortable table from data.json. No backend, no server code.

Vite, Astro, or a single index.html all work. If your project has a build step, commit its output: Stackboard runs what’s in the repository and won’t build for you.

2. Push to a git provider

git init
git add -A
git commit -m "Initial version"
git remote add origin <your-repository-url>
git push -u origin main

Commit your build output if you have one, but never API keys. Anything in the repository is readable by whoever opens the app, so credentials go in the Deployable’s secrets instead.

3. Create the Deployable

In Stackboard, choose Create a deployable and set:

• Repository URL and branch
• Entry file, if your index.html isn’t at the repository root. For a built project this is usually dist/index.html or build/index.html
• Name, description, and tags for the catalog
• Owner: yourself, or a group

Secrets and API targets can be set here too, or added later. See Developing for Stackboard.

If the page comes up empty, the entry path is usually pointing at the wrong file. See Developing for Stackboard.

4. Share it

A new Deployable starts at Only me. Change the sharing scope to reach specific people and groups, the whole organization, or anyone with the link. See Sharing.

From here, git push is the whole deploy process, unless you’ve pinned the Deployable to a release or a commit.