Every change to your app happens through the chat conversation. Describe what you want updated and the AI makes the change — no code editor, no settings panel. The same goes for renaming, deleting, and downloading your project.
Making changes
Type your change request in the chat and send it. Be as specific or as general as you like:
- "Change the background color of the header to dark blue"
- "Add a search bar to the top of the product list"
- "Fix the bug where submitting the form clears all the fields"
- "Redesign the homepage to feel more minimal"
Every change goes to your draft first. Review it at the draft URL before pushing it live.
If you want to collect feedback before asking Caffeine to make changes, use project comments. You can leave notes on the draft preview, review them in one place, and choose which ones Caffeine should build. See Using Project Comments.
Project naming
When you start a new project, the AI automatically gives it a short descriptive name based on what you asked it to build. You'll see the name appear in the project list and at the top of the chat panel.
If you want a different name, just ask: "Rename this project to [new name]." The AI renames it immediately. You can do this at any time during the conversation.
Viewing your app preview on desktop
On desktop, the workspace uses a side-by-side split view: your chat conversation sits on the left and a live preview of your app sits on the right. The preview pane is hidden by default and appears once your project has a built draft.
To show or hide the preview, click the Eye icon in the header toolbar. The Eye icon is greyed out and disabled until a draft exists. Once a draft is available, clicking the Eye reveals the preview pane alongside the chat; clicking it again hides it.
You can resize the two panes by dragging the divider between them. The split is saved per project, so Caffeine remembers your preferred layout next time you open that project.
If the sidebar is open and the viewport is narrow, the preview pane automatically overlaps the chat rather than squeezing it — so the chat is always fully usable.
On mobile and tablet, the chat and preview remain on separate tabs as before.
Viewing your code and assets
You can open the code explorer panel to browse all the files in your project — source files, stylesheets, assets, and images. Click on any file in the left-hand tree to see its contents on the right.
When you select an image file (such as a PNG, JPG, WebP, GIF, BMP, or ICO file), the code explorer shows the actual image instead of the raw file data — so you can confirm which asset is which without leaving the panel. SVG files still appear as code, since their markup is often useful to inspect as text.
App icon
Each project can have a custom app icon. The icon appears next to your project in the sidebar and in your project settings. If you publish your app to the App Market, the icon is also used as the listing icon there.
To manage your app icon, open your project settings and find the App icon section. You have three options:
- Generate with AI — click Generate with AI to let Caffeine create an icon for you based on your project. This costs 1 credit. Generation runs in the background and the icon updates automatically when ready.
- Upload — click Upload to choose an image file from your device. Accepted formats are JPEG, PNG, WebP, and GIF, up to 2 MB.
- Download — click Download to save the current icon to your device.
Downloading your source code
You can download the full source code for your project as a ZIP file at any time. See Downloading and Uploading Your Project Code
Uploading code from a ZIP file
If you have modified your project's source code outside of Caffeine — for example, after downloading it and making changes locally — you can upload it back as a ZIP file to create a new draft. See Downloading and Uploading Your Project Code
Deleting a project
Click the project tile or avatar on the projects list to open its settings, then choose the delete option. A confirmation dialog appears — type delete and click the button to confirm.
Warning: deleting a project permanently deletes both the draft and the live version of the app, including all data. This cannot be undone. If you want to keep the live app, detach it from the project before deleting.
To confirm deletion, you must type the exact name of the project into the confirmation field. The name is case-sensitive — it must match precisely. This prevents accidental deletions.
Your first project — the one created when you signed up — cannot be deleted. The delete option does not appear for it in settings.
If a deployment is currently in progress for the project — for example, you clicked Go live or Push version update moments earlier — the deletion will be blocked until the deployment finishes. Wait for the deployment to complete, then try again.
Remixing a version
Remixing lets you take any committed draft version of your own project and spin it up as a brand-new, independent project. The remix gets a full copy of the code, referenced assets, and the build for that version — but none of the original chat history. A fresh deployment starts automatically, so the remixed project is ready to build on straight away.
To remix a version, open the version history panel (click the version badge in the top-right corner of the app preview panel). Each version row shows a Remix this version button (the shuffle icon). Click it on the version you want to copy. Once the remix is ready you are taken directly to the new project.
The original project is unchanged — remixing never affects the parent.
Remixed projects start with a default name based on the parent. You can rename the project at any time by asking the AI.
Remixing is also one of the recovery paths when a project is blocked by a migration conflict that prevents new versions from deploying. Starting from a chosen version in a fresh project sidesteps any accumulated data layout from earlier versions. See Publishing and Sharing Your App for the full set of options in that scenario.
Frequently asked questions
How do I show or hide the app preview on desktop?
Click the Eye icon in the header toolbar to toggle the preview pane. The Eye control is disabled until your project has a built draft — once a draft exists, clicking it reveals the preview alongside the chat, and clicking it again hides it. The preview is hidden by default when you open a project for the first time.
Can I resize the chat and preview panes?
Yes. Drag the divider between the chat pane and the preview pane to adjust the split. Caffeine remembers the split for each project, so your preferred layout is restored next time you open it. On mobile and tablet the layout uses separate tabs, not a split view.
Can I undo a change the AI made?
There is no undo button, but you can revert to any previous draft version. Each successful build in your chat history has a Revert to version N button — clicking it restores your draft to that exact state. You can also ask the AI to reverse a specific change: "Undo the last change" or "Go back to how the homepage looked before."
What is click-to-edit?
Click-to-edit is a feature that lets you click directly on elements in your draft preview to focus the AI's attention on them. After clicking an element, your next message targets that specific part of the app. This makes it easier to make precise edits without having to describe where something is.
What are project comments?
Project comments let you leave notes while reviewing a draft, then decide later which comments Caffeine should turn into app updates. They are useful when you want to collect feedback first instead of sending every note directly to the chat. See Using Project Comments.
Can I edit the code directly?
You can view your app's generated code and assets in the code explorer panel. Direct editing of generated code is not supported — changes should be made through the chat. You can however download the source code and work with it externally. Image files (PNG, JPG, WebP, GIF, BMP, ICO) display as visual previews in the explorer rather than raw data.
What happens to my live app if I delete the project?
The live app is deleted along with the project. If you want to keep the live app running independently, contact support before deleting — there may be options to detach it.
Can I restore a deleted project?
No. Deletion is permanent. Make sure you want to delete before confirming. You will need to type the exact project name to complete the deletion.
Why is there no delete option for one of my projects?
Your first project — the one created automatically when you joined Caffeine — cannot be deleted. The delete option is not shown for it in settings.
I tried to delete a project but got an error saying a deployment is in progress — what should I do?
Caffeine blocks project deletion while a deployment is running to protect the integrity of the deployment process. Wait for the current deployment to finish — you can watch its progress in the chat header — then try deleting again. If the deployment takes longer than expected, contact support.
What is the difference between reverting and remixing a version?
Reverting replaces your current draft with an older version — the project continues as one project, just rolled back. Remixing creates a separate new project from an older version, leaving the original completely unchanged. Use revert when you want to go back; use remix when you want to explore a different direction without losing your current progress.
Does a remix include my chat history?
No. The new project starts with a clean chat. The remix carries over the code, assets, and build for the chosen version only.
Why can I only remix from committed versions?
Only versions that were fully built and saved can be remixed. Work-in-progress drafts that have not completed a build are not available as remix sources.
Does remixing use my project quota?
Yes. A remix creates a new project, so it counts toward your project limit just like any other project you create.
How is this different from remixing an app from the App Market?
Both features create a new project from existing code. Remixing a version works on your own projects and lets you branch off from any committed draft without publishing anything. Remixing from the App Market copies someone else's published app into a new project of your own. The mechanics are the same — you get the code and a fresh deployment — the difference is just the source.
Can I set an app icon for my project?
Yes. Open your project settings and find the App icon section. You can upload your own image (JPEG, PNG, WebP, or GIF, up to 2 MB), generate one with AI for 1 credit, or download the current icon. The icon appears in the sidebar and in settings. If you publish your app to the App Market, the same icon is used as your listing icon.
How much does it cost to generate an app icon with AI?
1 credit per generated icon. If you prefer not to spend credits, you can upload your own image instead.