Intro

Feather DS components are built using Vue3. If you haven't already set up your Vue3 project we recommend either using Vite or Vue CLI v5 to get your project set up and running. FeatherDS requires the use of a Javascript Bundler and cannot be consumed directly in the browser.

Prerequisites

Before you begin using Feather DS, you will need to have the following setup on your system;

Install

Once you have our prerequisites installed and your Vue3 project ready you can begin installing FeatherDS packages. The first package we recommend you install is our styles.

npm install @featherds/styles

After this package installs, check out our Theme Setup section which contains further details on how to integrate into your project.

When it comes time to install components, each of our component pages has their published package name displayed at the top of the page just before the title <H1>.

Buttons page example of package text location

To install the button example:

npm install @featherds/button

Theme Setup

To use a theme, first install the @featherds/styles package. You will want to import @featherds/styles and your default theme in the same file you call createApp. You can either install open-light.css or open-dark.css as your default theme.

import { createApp } from "vue";
import App from "./App.vue";
import "@featherds/styles";
import "@featherds/styles/themes/open-light.css";
createApp(App).mount("#app");

Once you have the imports setup you will need to add the .feather-styles class to the root node of your application. If you are using Feather DS in a legacy application and want to limit CSS bleed, put this class on the parent node of the DOM element containing the Feather DS components.

Using Components

When it comes time for you to use our components, each one has multiple examples to help you get started. They will detail how to import and use a component in different scenarios. The following workflow is for Vue SFC structure.

Import the component and declare it in the components section of your SFC.

import { FeatherButton } from "@featherds/button";

export default {
  //... your component configuration
  components: {
    FeatherButton,
  },
};

Now we can go ahead and start using the component inside the template section of your SFC.

<template>
  <section>
    <FeatherButton primary>Primary Button</FeatherButton>
    <FeatherButton secondary>Secondary Button</FeatherButton>
    <FeatherButton text>Text Button</FeatherButton>
  </section>
</template>

Browsers

We support the latest version of Edge, Chrome, Firefox and Safari on Desktop. Whilst our controls are built with responsive behavior in mind we are currently not actively testing on Mobile devices.

BrowserVersionPlatform
EdgeLatestDesktop
ChromeLatestDesktop
FirefoxLatestDesktop
SafariLatestDesktop

Support

Having issues? Please feel free to raise a Github Issue.

Contributing

Contributors are always welcome, from documentation changes to full features.

To begin contributing please check out Contributing.md for all the details.