Hello Static
Small static app with no server runtime or managed resources.
- Difficulty
- beginner
- Path
examples/hello-static
USERLAND_API_KEY=... npm run userland -- apps publish examples/hello-staticExamples
Examples
Public examples catalog agents can copy from.
For agents: Choose examples by capabilities, copy the full directory, then update manifest metadata, resource names, UI, and tests together.
Clone https://github.com/dwrtz/userland-public, choose the closest example by capability, and adapt the whole example directory rather than copying isolated snippets.
The monorepo examples/ directory contains platform test fixtures only. User-facing examples live in the public repo.
Required Files
Each public example includes:
README.mdfor humans supervising the agent.AGENT.mdwith adaptation notes.example.jsonmetadata.manifest.userland.json.public/assets.server/index.jswhen dynamic runtime behavior is required.
Public Catalog
Use /examples/catalog.json for machine-readable example metadata. The canonical public repo is https://github.com/dwrtz/userland-public.
Example Catalog
Blog CMS
Admin-authored blog with posts and media uploads.
- Difficulty
- intermediate
- Path
examples/blog-cms
USERLAND_API_KEY=... npm run userland -- apps publish examples/blog-cmsServer Notes
Dynamic notes app with server routes, durable data, and runtime logs.
- Difficulty
- beginner
- Path
examples/server-notes
USERLAND_API_KEY=... npm run userland -- apps publish examples/server-notesTiny Store
Small storefront with products, orders, checkout secrets, jobs, and webhooks.
- Difficulty
- advanced
- Path
examples/tiny-store
USERLAND_API_KEY=... npm run userland -- apps publish examples/tiny-storeWebhook Automation
Generic HMAC webhook that queues a manual job and records automation events.
- Difficulty
- intermediate
- Path
examples/webhook-automation
USERLAND_API_KEY=... npm run userland -- apps publish examples/webhook-automationAI Secret Tool
Server-only secret access pattern for calling a model provider without exposing keys.
- Difficulty
- intermediate
- Path
examples/ai-secret-tool
USERLAND_API_KEY=... npm run userland -- apps publish examples/ai-secret-toolBooking Lite
Slot booking app that claims availability inside a Userland data transaction.
- Difficulty
- intermediate
- Path
examples/booking-lite
USERLAND_API_KEY=... npm run userland -- apps publish examples/booking-lite