shadcn-ui/apps/v4/content/docs/installation/laravel.mdx

---
title: Laravel
description: Install and configure shadcn/ui for Laravel.
---

<Callout className="mb-6 border-emerald-600 bg-emerald-100 dark:border-emerald-400 dark:bg-emerald-900">

**Starting a new project?** Use [shadcn/create](/create) for a fully configured Laravel app with custom themes, Base UI or Radix, and icon libraries.

</Callout>

<Steps>

### Create Project

Start by creating a new Laravel project with Inertia and React using the Laravel installer:

```bash
laravel new my-app --react
```

### Run the shadcn/ui CLI

Run the `init` command to configure shadcn/ui in your Laravel project:

```bash
npx shadcn@latest init --force
```

If asked to overwrite the existing components, answer `y` to continue.

### Add Components

You can now start adding components to your project.

```bash
npx shadcn@latest add switch
```

The command above will add the `Switch` component to `resources/js/components/ui/switch.tsx`. You can then import it like this:

```tsx title="resources/js/pages/index.tsx" {1,6} showLineNumbers
import { Switch } from "@/components/ui/switch"

const MyPage = () => {
  return (
    <div>
      <Switch />
    </div>
  )
}

export default MyPage
```

</Steps>