Skip to content
freecodeDocsOpen workspace
Browse documentation

Build your first project

Describe a small app, try it in Preview, make one change, and publish it from the freecode workspace.

Start a project

Open the workspace. Under What do you want to build?, describe one small app and choose Start building. If a project is already open, choose New project → Start from scratch first. You can try your first few prompts without an account.

Example prompt

Build a packing list. Let me add an item, tick it off, and keep my list when I refresh the page.

If the workspace shows Turn off your ad blocker to keep building, allow ads on freecode and choose Reload. Your draft is saved.

Already have code? Import a GitHub repository instead.

Follow the build

freecode replies in the conversation as it works. Expand a step such as Run command to see the command and its output. Done means that step finished.

Example from project chat
freecode

Try it in Preview

Choose Preview in the toolbar. When the app appears, add “charger,” tick it off, and reload the page. The item and its check mark should both still be there.

If something is missing, say so in the same conversation: “I ticked off charger and reloaded, and the check mark was gone.” The agent keeps working on the files it just created.

Make one change

In What would you like to change?, enter “Add a button that clears only the checked items.” When the task finishes, open Changes to see which files it edited. Test the button in Preview with one item checked and one unchecked. Learn how to review and restore changes.

Publish it

Choose Publish and sign in if prompted. When Your site is live appears, open it. That link is the one to share. After later edits, choose Update site to publish them. Read about publishing and unpublishing.

Next, learn how projects work so you can reopen, rename, or archive what you built.