Flisk logoflisk/demosHow it worksGitHubSponsor

Personal Flisk demo

@DPadenAkaterry's Flisk stack

Try it live now

This stack runs on a GitHub runner. Available until 16:08 UTC, then it shuts down and these links stop working. The first load can take a few minutes.

Upvoting lifts this stack toward the top of the list on the home page. One vote per browser. You can also pop a stack's bubble there to vote for it.

Progress

Live, 1m left

  1. ✓
    Plan ready
  2. ✓
    Scaffolding with flisk
  3. ✓
    Repo pushed
  4. ✓
    Starting flisk up on a GitHub runner
  5. ✓
    LiveThe app is running above.

Nothing specific in the request, so this is the base stack. Mention postgres, workers, solidity, agents or vue to shape it.

Run it

Fork puts this stack in your own GitHub account, ready to change. On the fork page, untick "Copy the main branch only", then open the branch demo/dpadenakaterry-app-ea0fe2. Then flisk doctor and flisk up run it on your machine.

Or use the commands
npm install -g @flisk-sh/flisk
git clone -b demo/dpadenakaterry-app-ea0fe2 https://github.com/flisk-sh/demos.git app-demo
cd app-demo
flisk doctor
flisk up
Or scaffold it yourself
npm install -g @flisk-sh/flisk
flisk doctor
flisk project --yes
flisk resource web --type frontend --stack app --framework react --yes
flisk resource api --type backend --stack app --feature prisma --yes
flisk up app
flisk status

Open after flisk up

If port 80 is busy, Flisk picks 8080–8180; flisk status shows the exact address.

Your service.json files

One service.json each. Postgres comes from "prisma" and Traefik routing is built in, so neither needs its own file.

webfrontendreact app
// services/app/web/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "web",
  "appType": "frontend",
  "stack": "app",
  "port": 3000,
  "framework": "react",
  "dependsOn": [
    "api"
  ]
}
apibackendbun + hono API
// services/app/api/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "api",
  "appType": "backend",
  "stack": "app",
  "port": 4000,
  "healthCheckPath": "/health",
  "dependsOn": [
    "api-migrator"
  ],
  "featuresEnabled": [
    "prisma"
  ]
}
api-migratormigratorruns Prisma migrations against the shared Postgres before the api starts
// services/app/api-migrator/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "api-migrator",
  "appType": "migrator",
  "stack": "app"
}

Note: No frontend framework named, so this uses React. Say vue, svelte or solid to switch.

Make it yours

This stack is a plain git branch. Copy it, change any service.json or the code, and run it on your machine. Send your version back and we can show it here.

1. Copy the branch: the clone command is in Run it above.

2. Put it in your own repository (needs the GitHub CLI)

cd app-demo && rm -rf .git && git init -q -b main && git add -A && git commit -qm "my app" && gh repo create my-app-demo --source . --push --private

Add a badge to your README

Flisk bubble badge

Show that this stack is a Flisk bubble. The badge links back here and shows the upvotes.

Copy the markdown
[![Flisk bubble](https://demo.flisk.sh/badge/dpadenakaterry-app-ea0fe2.svg)](https://demo.flisk.sh/d/dpadenakaterry-app-ea0fe2)

Share it

Opens a ready-made post on X. You read it and send it yourself; nothing is posted for you.

Want one for a friend?

Ask @grok on X with their handle and what they build.