> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skarmy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for the problems you are most likely to hit, organised by what you can see on screen.

Find your symptom below. Most problems here have a one-step fix.

## Building

<AccordionGroup>
  <Accordion title="The feed looks busy long after the work seems finished" icon="hourglass">
    **Reload the page.**

    The workspace tracks progress over a live connection. If that connection drops, the display can keep showing the old state after the Builder has actually finished. Reloading reconnects and reads the true state.

    You are not losing work, and reloading does not cost extra credits.
  </Accordion>

  <Accordion title="The preview never appears" icon="eye-slash">
    Check what the preview pane says:

    * `preview starting…` — nearly there. Wait a few seconds.
    * `this session is asleep` — select **Wake preview** or send a message.
    * `no live preview` — the build settled without a running app. Ask for a change to keep building, or publish.

    If it stays on `preview starting…` for more than a couple of minutes, reload the page.
  </Accordion>

  <Accordion title="The Builder seems stuck partway through" icon="circle-pause">
    First reload — the display may simply be stale.

    If it is genuinely stuck, select **Stop**, then send:

    ```text theme={null}
    Continue where you left off.
    ```

    If that does not help, **Start fresh** archives the session and starts over. Your files and published site are kept.
  </Accordion>

  <Accordion title="The Builder changed more than I asked for" icon="scissors">
    Ask it to revert that specific part. Naming exactly what you want back is more reliable than "undo that".

    Smaller, more specific requests stay better scoped.
  </Accordion>

  <Accordion title="The preview looks broken mid-build" icon="triangle-exclamation">
    Usually temporary — the Builder fixes its own breakage as it goes and does not report routine recovery.

    If it stays broken, describe what you see in plain terms: "the homepage is blank" or "the schedule section shows an error".
  </Accordion>
</AccordionGroup>

## Publishing

<AccordionGroup>
  <Accordion title="'Nothing to publish yet. Finish a build first'" icon="ban">
    Publishing ships your last **completed** milestone. Wait for the Builder's summary, then publish.
  </Accordion>

  <Accordion title="'That name is already taken' or 'That name is reserved'" icon="link-slash">
    Addresses are globally unique, and some names are reserved. Pick another — see [Site addresses](/publish/site-addresses).
  </Accordion>

  <Accordion title="'Use 3–63 lowercase letters, numbers, or hyphens'" icon="keyboard">
    Remove capitals, spaces, accents, and symbols. The name cannot start or end with a hyphen.
  </Accordion>

  <Accordion title="'That approval expired' or 'Your files changed since this was proposed'" icon="clock">
    The review dialog describes one exact version, and it went stale — either time passed or the Builder kept working. Select **Publish** again to review the current version.
  </Accordion>

  <Accordion title="'Publish failed. Try again'" icon="rotate">
    Select **Publish** again. A failed publish leaves your existing live site untouched and never releases your claimed name.
  </Accordion>

  <Accordion title="My live site still shows the old version" icon="clock-rotate-left">
    Published sites are snapshots — they update only when you publish again. If you have published, hard-refresh or open the site in a private window to bypass your browser cache.

    See [Update a published site](/publish/update-a-published-site).
  </Accordion>

  <Accordion title="I claimed the wrong address" icon="pen-slash">
    Addresses cannot currently be changed. Create a new workspace and publish that to the name you want.
  </Accordion>
</AccordionGroup>

## Credits and billing

<AccordionGroup>
  <Accordion title="'You're out of credits. Top up on the Usage page'" icon="coins">
    Add credits on the **Usage** page, or wait for your daily allowance to refill at midnight UTC.

    Nothing is lost while you are out of credits.
  </Accordion>

  <Accordion title="My balance dropped faster than expected" icon="chart-line">
    Three things spend credits: the Builder working, the machine running your app while awake, and publishing.

    Check **Last 30 days** on the **Usage** page for the breakdown, and see [Track your usage](/credits/track-usage) for ways to spend less.
  </Accordion>

  <Accordion title="I paid but my balance didn't change" icon="credit-card">
    Select **Refresh usage**. Settlement can lag by a few minutes. If it persists, contact support.
  </Accordion>

  <Accordion title="Usage has paused unexpectedly" icon="hand">
    Check **Monthly spend limit** on the **Usage** page. Usage pauses for the month once spend reaches your cap.
  </Accordion>
</AccordionGroup>

## Running your company

<AccordionGroup>
  <Accordion title="No task suggestions today" icon="list-check">
    Suggestions start after your first build. On your first visit of the day the slate can take a moment — `Still putting today's tasks together. Try again in a moment.` And some days the generator genuinely has nothing to add.
  </Accordion>

  <Accordion title="An automation is 'Paused after failing'" icon="clock">
    Open its run history to see what went wrong — usually an app connection that needs reconnecting or a job description that needs sharpening. Fix it and resume.
  </Accordion>

  <Accordion title="Company email won't send" icon="envelope">
    Either you hit the daily send limit (it resets tomorrow; paid plans have a higher limit) or sending is paused for delivery problems — the page says so. Receiving always works. See [Your company inbox](/company/inbox).
  </Accordion>

  <Accordion title="Skarmy refuses to do something in a connected app" icon="plug">
    Deleting is never done, sending never happens from automations, and a skill you switched off refuses by name. See [App permissions](/company/app-permissions).
  </Accordion>
</AccordionGroup>

## Account

<AccordionGroup>
  <Accordion title="I built something as a guest and don't want to lose it" icon="user-plus">
    Create an account. Everything you started as a guest moves across.

    You must sign up before you can open the Builder or publish.
  </Accordion>

  <Accordion title="My company is still called 'Untitled Company'" icon="signature">
    Set the name in **Settings** → **Company** → **Overview**, or ask the coach to rename it.
  </Accordion>

  <Accordion title="I can't find a workspace" icon="magnifying-glass">
    Check which company is active in the switcher at the top of the sidebar. Workspaces belong to a company, and the app only shows the active one's. Search (**⌘K**) also finds them by name.
  </Accordion>

  <Accordion title="I can sign in, but every action fails" icon="shield-halved">
    Some privacy extensions and browser settings strip the security header Skarmy uses to verify that requests really come from you. Try a different browser or disable the extension for `app.skarmy.ai`.
  </Accordion>

  <Accordion title="I want to add a teammate" icon="users">
    Not available yet. Sending an invite returns *Invites are coming soon*.
  </Accordion>
</AccordionGroup>

## Still stuck

* Check [status.skarmy.ai](https://status.skarmy.ai) for a live incident.
* Ask in the [Skarmy community](https://www.skarmy.ai/community).
* Read the [FAQ](/account/faq).

## Next

<Columns cols={2}>
  <Card title="Session states" icon="list-check" href="/account/session-states">
    What each session state means.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/account/faq">
    Short answers to common questions.
  </Card>
</Columns>