Val Town Community Showcase

This val powers the Community Showcase (https://www.val.town/explore/community-showcase) — the hand-picked gallery of great things the Val Town community has built. The showcase page fetches this val live at https://showcase.val.run, so editing the staffPicks array in main.tsx here updates the page directly.

Want your app featured? Read on. 👇

🚀 Submit your app (easy way — no coding required!)

You can send us your project in seconds with a simple POST request. We'll get an email at hi@val.town and review it for the showcase.

Send a POST to https://showcase.val.run with JSON like this:

curl -X POST https://showcase.val.run \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Cool App",
    "handle": "yourHandle",
    "projectName": "my-cool-app",
    "description": "A one-sentence description of what it does.",
    "notes": "Optional — anything else you want to tell us"
  }'

Required fields: name, handle, projectName, description Optional fields: url (if it's not a Val Town project), notes

You'll get a JSON response confirming your submission. That's it — we'll take it from here!

Prefer email? You can also just email us at hi@val.town with your project name, Val Town handle, and a short description.

Want your app in the showcase? (other paths)

There are two more paths depending on who you are:

If you work at Val Town

You can edit this val directly. Add an entry and a card image:

Open main.tsx and add a new object at the top of the staffPicks array (just inside the [). Use the entry shape below, with a unique id bumped above the current max.
Make a card image (the floating browser-window-on-a-pastel-gradient look) and upload it to Cloudflare Images — see "Card image" below and the full SKILL.md in this val for the exact recipe.
Save. The change goes live immediately at https://showcase.val.run and on the showcase page.

If you don't work at Val Town (everyone else 💛)

You can either use the easy POST submission above, or open a pull request on this val:

Open this val: https://www.val.town/x/valdottown/staffPicks
Create a branch (use the branch menu in the Val Town editor), add your entry to the top of the staffPicks array in main.tsx, and add a card image (see below).
Submit a pull request from your branch. A Val Town team member will review it, make sure the card looks right, and merge it.

Not sure how to make the card image? No worries — open the PR with just the entry (and a screenshot or link to your app) and we'll help with the image.

Entry shape

{
  "id": "53",                    // unique string; bump above the current max
  "type": "project",             // "project" or "val"
  "name": "Display Name",
  "description": "One warm sentence describing the app.",
  "handle": "yourHandle",        // your Val Town username
  "projectName": "the-val-name", // for type:"project" (use "valName" for type:"val")
  "imageUrl": "https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/<id>/public"
}

The card links to /x/{handle}/{projectName} for projects, or /v/{handle}/{valName} for vals.

Card image

Each card is a screenshot of the app composited into a floating browser window on a soft pastel gradient (cropped ~1.91:1, hosted on Cloudflare Images).

Important: the browser window must float in the middle of the card with generous, roughly equal margins on all four sides — it should NOT fill the frame or sit cramped against the top/edges. Match (or exceed) the padding on the "Spend Agent" card. The window should be no more than ~72% of the card width and vertically centered.

The full step-by-step recipe (screenshot command, the exact gradient + window CSS, and the Cloudflare upload) lives in SKILL.md in this val.

Staff Picks, hand-curated by Team Val Town.

valdottown