Skip to content
freecodeDocsOpen workspace
Browse documentation

Start a project in your browser

Create a project on freecode.sh without installing anything, try a few prompts as a guest, and sign in to keep your work.

Create a project

On freecode.sh, describe what you want to build and choose Start coding. Your files live in a hosted workspace, so you don’t need to install Node.js or connect GitHub.

To start another project later, open the workspace and choose New project → Start from scratch. Describe the app and choose Start building.

Create a project in the web workspace

If you’re trying freecode for the first time, here’s a prompt you can test in Preview:

Example prompt

Make a packing list with a text field and an Add button. When I click an item, cross it off. Keep the list when I refresh the page.

When the task finishes, open Preview and try it. Add “phone charger,” cross it off, then refresh. If the check mark disappears, tell freecode exactly that in the same conversation.

Try it as a guest, sign in to keep it

You can start without an account. A guest project includes a few trial prompts, and the count appears under the message field. When they run out, the send button changes to Sign in to continue.

To keep your work, choose Sign in to keep your work and then Continue to sign in. Your project and usage carry over to your account. Publishing a site also requires signing in.

Reopen a project

Open the workspace and choose the project under Recent projects. On a small screen, open the projects menu first. Its conversation continues where you left off, and follow-up requests work on the same files.

If you can’t see it, choose Search projects and type part of the name, or check Archived projects. Learn more about projects.

Start from a GitHub repository

Choose Connect GitHub on the home page before submitting a prompt. Pick the repositories freecode can read, then choose the one to work on. See Import a GitHub repository for the full steps.

Files on your computer

A browser project does not watch a folder on your computer. To edit local files directly, open the folder in Desktop or run freecode from your terminal.