# Your first project

<TLDR>
Create a project from **New project**, start its Studio, ask the AI to build or change something, and check the result in **Preview**. Connect GitHub so your code is saved in your own repository.
</TLDR>

## What you will build [#what-you-will-build]

A <Term id="project">project</Term> with a running <Term id="studio">Studio</Term> and a first change made by AI, visible in the live preview. Agents, deploys and apps all live in a project.

## Before you start [#before-you-start]

- A Klarety <Term id="workspace">workspace</Term> on the free trial or Pro. See the [Quickstart](/docs/get-started/quickstart).
- <Term id="credits">Credits</Term>: a running Studio is priced per minute. Your balance is in <AppLink to="settings.usage" />.
- Optional: GitHub connected, so your code is kept in a repository you own. See [GitHub](/docs/connectors/github).

<Callout type="info" title="A running Studio uses credits">
A Studio is priced per minute while it runs. Stop it when you are done; your files are kept.
</Callout>

## Steps [#steps]

<Steps>
<Step>
### Create the project [#create-the-project]
Open <AppLink to="projects.new" />, or select **New project** on <AppLink to="home" />. Type a **Project name**. The other options have sensible defaults:

- **Size**: how much machine the Studio gets. Starter is plenty to begin.
- **How it runs**: the standard shared machine is the default. If it is taken back, a new one starts on its own and no work is lost. **Premium** is never interrupted.
- **<Term id="ai-harness">AI harness</Term>**: which AI tools the project uses.
- **Connect GitHub**: link a repository now, or later from the project's settings.
- **Invite people**: add teammates from your workspace.
- **Internet access**: whether the Studio can reach the whole web, only your connections and the sites you add, or nothing outside Klarety.

The form shows the Studio's cost per hour. Select **Create project**. Every option is explained in [Create a project](/docs/projects/create-a-project).

<Screenshot src="/docs/_media/new-project-advance-settings.png" alt="The New project form with Size, How it runs, Internet access and the cost per hour" />
</Step>
<Step>
### Start the Studio [#start-the-studio]
The project opens on its overview. If the Studio is not running, select **Start Studio**. The status moves from **Studio starting** to **Studio running**.
</Step>
<Step>
### Ask the AI to make something [#ask-the-ai-to-make-something]
Open the **AI** tab and describe what you want, for example:

> Build a small web page that lists the tables in my workspace and how many rows each one has.

The AI reads your project, writes the code and runs it, showing every step.

<Screenshot src="/docs/_media/studio-ai-chat.png" alt="The Studio's AI chat inside a project" caption="The AI tab: describe a change and watch the AI make it." />

Use Klarety's AI, or your own Claude Code, Codex or Cursor subscription. See the [AI harness](/docs/ai-harness).
</Step>
<Step>
### See the result [#see-the-result]
**Preview** shows the running app; **Code** lets you edit the files. Split the tabs side by side to watch the preview while the AI works.

<Screenshot src="/docs/_media/project-page-running-klarety-code-new-session.png" alt="The Studio with the AI and Preview tabs split side by side" />
</Step>
<Step>
### Save your code to GitHub [#save-your-code-to-github]
If linked to a repository, push from the Studio. If not, select **Connect GitHub to keep your code safe** on the overview and choose a repository.
</Step>
<Step>
### Stop the Studio when you are done [#stop-the-studio-when-you-are-done]
Select **Stop Studio**. Files are kept, a stopped Studio uses no credits for running time, and you can start it again any time.
</Step>
</Steps>

## Check that it worked [#check-that-it-worked]

- The project appears in <AppLink to="projects" /> with its Studio status.
- **Preview** shows the page the AI built.
- If you linked GitHub, the overview's **Code** card says the code is saved in your repository.
- The project's **Activity** shows your Studio session.

## Common variations [#common-variations]

- **Start from an existing repository.** Link a GitHub repository when creating the project; the AI works on your real code.
- **Work with a teammate.** Add them under **Invite people**, or later in the project's **People** settings. Each person runs their own AI session in the same Studio. See [Working together](/docs/ai-harness/working-together).
- **Try a risky change safely.** Ask the AI to work in a copy, a separate branch, so your main code stays as it is. See [Copies](/docs/ai-harness/copies).

## If something goes wrong [#if-something-goes-wrong]

<Accordions>
<Accordion title="Start Studio says I am out of credits">
Buy more credits or check your monthly credits in <AppLink to="settings.usage" />.
</Accordion>
<Accordion title="An option shows Not on your plan">
Some sizes and options depend on your plan. Keep the default, or see <AppLink to="settings.billing" /> to compare plans.
</Accordion>
<Accordion title="The Studio cannot reach a website">
Check **Internet access** in the project's settings. With only allowed sites, add the site. With internet off, the Studio cannot reach anything outside Klarety.
</Accordion>
<Accordion title="The Studio failed to start">
Select **Start Studio** again. If you chose a standard machine and it was taken back, a new one starts on its own and your work is kept.
</Accordion>
</Accordions>

## Next steps [#next-steps]

- [Turn a spreadsheet into a table](/docs/guides/spreadsheet-to-table): give your project data to work with.
- [Deploy your first app](/docs/guides/first-deploy): put what you built online.
- [The Studio](/docs/projects/studio): everything a Studio can do.
- [Klarety Buddy](/docs/projects/buddy): AI code review for your project.