@vtmn/svelte

@vtmn/svelte

Decathlon Design System - Vitamin Svelte components library

Install package

After installing npm or yarn, you can install @vtmn/svelte with this command:

# with npm
npm i -S @vtmn/svelte

# with yarn
yarn add @vtmn/svelte

Install fonts

Roboto & Roboto Condensed fonts as described in Typography section will not be automatically loaded. Fortunately, there is a few easy ways to get started.

Shown below is a sample link markup used to load from a CDN:

<link
  rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&family=Roboto+Condensed:ital,wght@0,400;0,700;1,700&display=swap"
/>

You can also do it via CSS Import:

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&family=Roboto+Condensed:ital,wght@0,400;0,700;1,700&display=swap');

Otherwise, you can install them with typeface:

# with npm
npm i -S typeface-roboto typeface-roboto-condensed

# with yarn
yarn add typeface-roboto typeface-roboto-condensed

Then, you can import them in your entry-point:

import 'typeface-roboto';
import 'typeface-roboto-condensed';

Install icons (optional)

If you need to use Svelte components with icons displayed (via props for icons in some components), you will need to install @vtmn/icons package.

# with npm
npm i -S @vtmn/icons

# with yarn
yarn add @vtmn/icons

Then, import the icon font in the entry point of your React application:

import '@vtmn/icons/dist/vitamix/font/vitamix.css';

Or you can also import it with a CDN like unpkg.com with this file.

Usage

You may want to use the source Svelte files to benefit from some features (Server Side Rendering for instance). To do so, you will need to import components exposed in the src/ folder of the package.

Example with VtmnButton :

// App.svelte
<script>
  import VtmnButton from '@vtmn/svelte/src/components/VtmnButton.svelte';
</script>

<VtmnButton>Button</VtmnButton>

Development

To know all the use cases and their associated code, check out the showcase here.

Changelog

If you want to know the different changes between versions of this package, look at the changelog here.

I have an issue, what should I do?

Please file the issue here.

Contributing

See the contributing docs.

License

Apache-2.0 © Decathlon