Psst — looking for an app template? Go here --> sveltejs/template


Svelte 3 Component Template

Getting started

  1. Clone it with degit:
npx degit Vehmloewff/svelte-component-template my-new-component
  1. cd into the folder and install the node_modules:
cd my-new-component
npm ci
  • The ci command makes sure your packages match the one in the package-lock.json (See here).
  1. Run npm init, to configure the project.
  2. Replace this README with your own.

Your component's source code lives in src/components/[MyComponent].svelte.

Developing

  1. Start Rollup:
npm run dev
  1. Edit a component file in src/components, save it, and reload the page to see your changes.

  2. Make sure your component is exported in src/components/components.module.js.

  3. Make sure your component is imported and nested in src/App.svelte.

  4. Navigate to localhost:5000 to see your components live.

Consuming components

Your package.json has a "svelte" field pointing to src/components/components.module.js, which allows Svelte apps to import the source code directly, if they are using a bundler plugin like rollup-plugin-svelte or svelte-loader (where resolve.mainFields in your webpack config includes "svelte"). This is recommended.

For everyone else, npm run build will bundle your component's source code into a plain JavaScript module (index.mjs) and a UMD script (index.js), in the dist folder.
This will happen automatically when you publish your component to npm, courtesy of the prepublishOnly hook in package.json.

Publishing to npm

Credits & Inspiration

Top categories

svelte logo

Want a Svelte site built?

Hire a Svelte developer
Loading Svelte Themes