Docs
Installation

Installation

How to install dependencies and structure your app.

Guides

Imports

Unlike the original shadcn/ui for React, where the full components can exist in a single file, components in this port are split into multiple files. This is because Svelte doesn't support defining multiple components in a single file, so utilizing the CLI to add components will be the optimal approach.

The CLI will create a folder for each component, which will sometimes just contain a single Svelte file, and in other times, multiple files. Within each folder, there will be an index.ts file that exports the component(s), so you can import them from a single file.

For example, the Accordion component is split into four .svelte files:

  • accordion.svelte
  • accordion-content.svelte
  • accordion-item.svelte
  • accordion-trigger.svelte

They can then be imported from the accordion/index.ts file like so:

	import * as Accordion from '$lib/components/ui/accordion"
// or
import {
  Accordion,
  AccordionContent,
  AccordionItem,
  AccordionTrigger
} from "$lib/components/ui/accordion"

Regardless of the import approach you take, the components will be tree-shaken by Rollup, so you don't have to worry about unused components being bundled into your app.

TypeScript

This project and the components are written in TypeScript. We recommend using TypeScript for your project as well.

However, we provide a JavaScript version of the components as well. The JavaScript version is only available via the CLI.

Opt-out of TypeScript

To opt out of TypeScript, set the typescript flag to false in your components.json file.

components.json
	{
  "style": "default",
  "tailwind": {
    "config": "tailwind.config.js",
    "css": "src/app.css"
  },
  "typescript": false,
  "aliases": {
    "utils": "$lib/utils",
    "components": "$lib/components",
    "hooks": "$lib/hooks",
    "ui": "$lib/components/ui"
  },
  "registry": "https://next.shadcn-svelte.com/registry"
}

To configure import aliases, create a jsconfig.json file:

jsconfig.json
	{
  "compilerOptions": {
    "paths": {
      "$lib/*": ["./src/lib/*"]
    }
  }
}

ESLint configuration

If you are using ESLint, some components may trigger false positives depending on your ESLint configuration. For example, you could end up with lint errors when components define $$Props to specify the type for $$restProps as $$Props is not directly used in the rest of the component.

To ignore these linting errors, you can modify your ESLint configuration.

One option is to add a .eslintrc file in the directory where you define your components, $lib/components/ui for example:

src/lib/components/ui/.eslintrc
	{
  "rules": {
    "@typescript-eslint/no-unused-vars": [
      "warn",
      {
        "argsIgnorePattern": "^_",
        "varsIgnorePattern": "^\\$\\$(Props|Events|Slots|Generic)$"
      }
    ]
  }
}

The main benefit of adding an additional .eslintrc file just to $lib/components/ui is that you will not affect how ESLint functions for the rest of your project. Only your shadcn-svelte components will ignore these false positives.

If this is not important to you, then another option is to use a similar rule override in your global ESLint configuration file, usually .eslintrc.cjs. For inspiration, please refer to this gist.

If your global ESLint configuration is using the flat config format or you would like to migrate to the flat config format Configuration Migration Guide you could add another rule block in your eslint.config.js for example:

src/eslint.config.js
	/** @type {import('eslint').Linter.FlatConfig[]} */
export default [
  /* ... */
  {
    files: ["**/*.svelte"],
    languageOptions: {
      parserOptions: {
        parser: ts.parser,
      },
    },
  },
  {
    /* location of your components where you would like to apply these rules  */
    files: ["**/components/ui/**/*.svelte"],
    rules: {
      "@typescript-eslint/no-unused-vars": [
        "warn",
        {
          argsIgnorePattern: "^_",
          varsIgnorePattern: "^\$\$(Props|Events|Slots|Generic)$",
        },
      ],
    },
  },
];

VSCode extension

Install the shadcn-svelte VSCode extension by @selemondev in Visual Studio Code to easily add Shadcn Svelte components to your project.

This extension offers a range of features:

  • Ability to initialize the shadcn-svelte CLI
  • Add components to your project
  • Navigate to a specific component's documentation page directly from your IDE
  • Handy snippets for quick component imports and markup

JetBrains IDEs extension

Install the shadcn/ui Components Manager JetBrains extension by @WarningImHack3r in any JetBrains IDE (IntelliJ IDEA, WebStorm...) to easily manage shadcn components within your project.

This extension offers a range of features, including:

  • Automatically detect shadcn/ui components in your project
  • Instantly add, remove, and update them with a single click
  • Supports all shadcn/ui implementations: Svelte, React, Vue, and Solid
  • Easily search for remote or existing components