Deploy and run
Starters
Deploy a working Next.js, FastAPI, Discord bot or cron worker app in one click, then make it your own.
Starters are small, real apps you can deploy with one click and open a minute later: a landing page, a waitlist, an AI chatbot, a Discord bot, Next.js with Postgres and more. They're the quickest way to see CLI work, and a good base for your own thing.
How to do it: under Put something online, pick a starter, fill in anything it asks for, and press Deploy. Then change its code like any other app.
"Deploy the waitlist starter and call it Launchpad."
Starters are small, real apps you can deploy with one click, open a minute later, and then change. They're the quickest way to see CLI work end to end, and a good base for something of your own.
The starters
| Starter | What you get | Needs |
|---|---|---|
| Next.js + Postgres | A Next.js app (App Router) with a notes page stored in Postgres | Nothing |
| FastAPI + Postgres | A Python API with GET and POST /items stored in Postgres, and interactive docs at /docs | Nothing |
| Discord bot | A discord.js bot that answers /ping | Your bot's token and application id |
| Cron worker | A Python job that runs every hour, with its output and failures in the dashboard | Optionally, a URL for the example job to check |
| Landing page | A fast one-page site with a headline, three features and a sign-up button. Plain HTML and CSS you edit in public/ | Optionally, the site's name |
| Waitlist + Postgres | A sign-up page that saves emails to Postgres, plus /admin to see them and download a CSV. Its password is the ADMIN_KEY variable, made for you | Optionally, what people sign up for |
| AI chatbot | A chat page that talks to an AI model with your instructions | Nothing when the server offers AI models (billed from project credit, see /docs/ai-gateway); otherwise your OpenAI key |
Every starter answers GET /health, so CLI knows when it's up, and the ones with a database get DATABASE_URL wired in for them.
Deploy one
In the dashboard: under Put something online on the Projects page, pick a starter. Each shows what it costs a month, and asks its questions (the Discord bot's token, say) before it starts. Inside a project, they're also under Templates, Start from working code. New accounts can also start from Try a demo.
Ask your agent:
"Deploy the FastAPI starter in my shop project."
With the API:
POST /v1/projects/:id/templates/starter-fastapi{ "inputs": {} }The ids are starter-nextjs-postgres, starter-fastapi, starter-discord-bot, starter-cron-worker, starter-landing-page, starter-waitlist and starter-ai-chat. With CLI's AI models on, the chatbot gets an AI key for the project (OPENAI_BASE_URL, OPENAI_API_KEY, AI_MODEL); without them it needs {"inputs": {"openaiKey": "sk-…"}}. GET /v1/templates lists them with "starter": true.
Make it yours
The code lives in the public clicloud-app/starters repository, one folder per starter. To change it:
- Fork
clicloud-app/starters(or copy the folder into a repository of your own). - Open the service's settings and point its source at your repository. Keep the root directory (for example
fastapi) if you forked the whole repository. - Push a change. CLI deploys it.
For the Discord bot, invite it to a server from the Discord developer portal (OAuth2 → URL generator, scopes applications.commands and bot), then type /ping. For the cron worker, edit job.py; run it any time from the service's cron jobs.