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

# Installation

> How to install and set up next-lovable CLI version 0.0.6

## System Requirements

<CardGroup cols={2}>
  <Card title="Node.js" icon="node-js">
    Version 18.x or higher
  </Card>

  <Card title="Package Manager" icon="box">
    npm, yarn, or pnpm
  </Card>
</CardGroup>

## Installation Methods

### Global Installation (Recommended)

Install next-lovable globally to use it from anywhere:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g next-lovable@0.0.6
  ```

  ```bash yarn theme={null}
  yarn global add next-lovable@0.0.6
  ```

  ```bash pnpm theme={null}
  pnpm add -g next-lovable@0.0.6
  ```
</CodeGroup>

<Note>
  Global installation allows you to run `next-lovable` from any directory on your system.
</Note>

## Verify Installation

Check if next-lovable is installed correctly:

```bash theme={null}
next-lovable --version
```

You should see version 0.0.6 displayed.

## Updating to Newer Version

To update to the latest version with more features:

<CodeGroup>
  ```bash npm theme={null}
  npm update -g next-lovable
  ```

  ```bash yarn theme={null}
  yarn global upgrade next-lovable
  ```

  ```bash pnpm theme={null}
  pnpm update -g next-lovable
  ```
</CodeGroup>

<Tip>
  **Recommended**: Consider upgrading to version 0.0.7+ which offers free single file conversions without authentication requirements.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Permission Denied Error">
    If you get permission errors on macOS/Linux, try:

    ```bash theme={null}
    sudo npm install -g next-lovable@0.0.6
    ```

    Or better yet, configure npm to use a different directory:

    ```bash theme={null}
    mkdir ~/.npm-global
    npm config set prefix '~/.npm-global'
    echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Accordion>

  <Accordion title="Command Not Found">
    If `next-lovable` command is not found after installation:

    1. Restart your terminal
    2. Check if the npm global bin directory is in your PATH:
       ```bash theme={null}
       npm config get prefix
       echo $PATH
       ```
    3. Add npm global bin to your PATH if missing
  </Accordion>

  <Accordion title="Authentication Issues">
    If you cannot authenticate:

    1. Ensure you have a valid account at nextlovable.com
    2. Check that your API key is correctly copied
    3. Verify network connectivity to api.nextlovable.com
    4. Try re-running the auth command
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Quick Start Guide" href="/0.0.6/quick-start" icon="rocket">
    Learn the basics with a simple example
  </Card>

  <Card title="Migration Command" href="/0.0.6/commands/migrate" icon="folder-arrow-right">
    Learn about project migration
  </Card>
</CardGroup>