Gamesight App Platform

A platform app is a Hono API and a Vue frontend behind one CloudFront origin at https://<slug>.apps.gamesight.dev, with staging at <slug>.staging.apps.gamesight.dev. The platform owns the AWS account, the git repository, the pipeline and every deploy. gsapp is the way in.

Install

curl -fsSL https://apps.gamesight.dev/install | sh

Needs Node 22 and npm. Everything else is checked by gsapp setup.

Prerequisites

gsapp setup checks these and prints the fix for anything missing:

• git
• Node 22 and pnpm
• uv, and git-remote-codecommit — how gsapp deploy pushes
• Docker — optional, needed by gsapp dev for apps that declare tables
• A Gamesight Google login

First app in five minutes

gsapp setup
gsapp create my-app --description "One line about it"

A slug is a lowercase DNS label, 3–40 characters. Creating an app provisions an AWS account and a pipeline, which takes about 20 minutes — so it is the one step that is not five minutes. Re-run it to pick up where it left off.

gsapp clone my-app
cd my-app
gsapp link          # writes .npmrc so pnpm can read the platform registry
pnpm install
gsapp dev           # api on :8787, web on :8786

Then deploy and publish it:

gsapp deploy        # branch, commit, pull request, green CI, staging
gsapp publish       # the staged commit to prod
gsapp logs --env staging

Raw git push is not the route — gsapp deploy opens the pull request the pipeline watches.

More

• gsapp --help lists everything.
• gsapp setup installs a Claude Code skill, so Claude knows the platform without being told.
• gsapp share my-app --allow you@gamesight.io lets someone else in.
• gsapp update self upgrades the CLI.