Creating Apps

Types of apps

• Internal apps

  • We store your code in an internal repo (managed for you)
  • You can stage → commit → deploy right from the app
  • Great for quick iteration from chat and templates

• GitHub apps

  • Code lives in your GitHub repo
  • You push commits to GitHub; we deploy those
  • Great if you already have a repo or want full control via GitHub

---

Creating apps

There are three ways to create an app:

1. Chat (fastest)

• Go to the Chat Builder: /builder
• Your first message is treated as the “what to build” app
• We create an internal app and auto‑deploy a preview from that first message

How updates work after that:

• Ask for a change in chat or from the Code tab in Projects
• We show you code suggestions (nothing is written yet)
• You click "Apply" on the files you want (stages the changes)
• Add a commit message and "Commit"
• Click "Deploy Preview", and when happy, "Promote to Production"

1. GitHub

• Use /projects/new
• Pick a repo (or connect one)
• We deploy from your GitHub code; you keep committing to GitHub like normal
• The app UI shows deployments and logs, but commits still happen in GitHub

1. Template

• Use /projects/new
• Pick a template to start from
• We copy the template files into an internal repo and auto‑deploy a preview

---

Updating apps

You can update internal apps (including chat‑created apps) from either place:

• From Chat Builder (/builder)

  • Ask for a change in plain English
  • We show code proposals.
  • Click Apply on the files you want, then add a message and Commit
  • Deploy Preview to test, then Promote to Production when ready

• From Projects (/projects/{team}/{app}/code)

  • Open the Code tab. You get a file tree + editor.
  • The Code Assistant panel can suggest changes (proposals) while you edit.
  • Apply the suggestions you want, then add a commit message and Commit.
  • Deploy Preview, then Promote to Production when ready.