detfaellesdesignsystem / dkfds-components

Styling og komponenter
Other
43 stars 13 forks source link

FDS - Det Fælles Designsystem

For guidelines and full documentation, visit https://designsystem.dk/

Using the design system in your project

There are a few different ways to use the design system within your project. Which one you choose depends on the needs of your project and how you are most comfortable working. Here are a few notes on what to consider when deciding which installation method to use:

Install using npm (recommended)

Install dkfds in your project by writing the following in a command-prompt:

  npm install --save dkfds

The dkfds module is now installed as a dependency. You can use the un-compiled files found in the src/ or the compiled files in the dist/ directory.

Download

Download the design system as a zip file and open that file.

Including FDS in your project

FDS as vendor

If you downloaded the project as a zip folder simply include the follow code in the head-part of your page to include the css:

  <link type='text/css' rel='stylesheet' href='[path to dkfds folder]/dist/css/dkfds.css'>

To include the javascript, include this tag at the bottom of the body-part of your page:

  <script src='[path to dkfds folder]/dist/js/dkfds.js'></script>

To include the styling add the following code to your main.scss file:

  @use 'node_modules/dkfds/src/stylesheets/dkfds' with (
    $font-path:         'node_modules/dkfds/src/fonts/IBMPlexSans/',
    $image-path:        'node_modules/dkfds/src/img/',
    $icons-folder-path: 'node_modules/dkfds/src/img/svg-icons/'
);

To include the JavaScript, import it in your main.js file:

  import * as DKFDS from "dkfds";

Contribute

The project is available on GitHub. You are more than welcome to contact us with suggestions or bug reports. See the project on GitHub