Docs menu

Deploy and run

Starters

Deploy a working Next.js, FastAPI, Discord bot or cron worker app in one click, then make it your own.

Explain it

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

StarterWhat you getNeeds
Next.js + PostgresA Next.js app (App Router) with a notes page stored in PostgresNothing
FastAPI + PostgresA Python API with GET and POST /items stored in Postgres, and interactive docs at /docsNothing
Discord botA discord.js bot that answers /pingYour bot's token and application id
Cron workerA Python job that runs every hour, with its output and failures in the dashboardOptionally, a URL for the example job to check
Landing pageA 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 + PostgresA 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 youOptionally, what people sign up for
AI chatbotA chat page that talks to an AI model with your instructionsNothing 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:

API
POST /v1/projects/:id/templates/starter-fastapi
JSON
{ "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:

  1. Fork clicloud-app/starters (or copy the folder into a repository of your own).
  2. 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.
  3. 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.