-
Notifications
You must be signed in to change notification settings - Fork 224
Directory Structure
Below is the design system’s basic structure. The system’s pieces are split into tokens
, elements
, patterns
and templates
as explained in the Terminology section.
There’s also styles
directory which includes generic functions
, mixins
and variables
that you might need. Currently, there’s for example a set of functions that can create tints and shades out of colors defined in tokens
.
assets
directory is meant for any static files like for example icons, fonts and similar.
Router
maps templates
to the routes and lets vue-router know when and where to render them.
docs
directory includes any custom content that is shown in the living system documentation.
config
directory includes configuration for the living system documentation, development environment, and build processes.
Finally, test
directory includes unit tests for Vue Design System.
├─ src
│ ├─ tokens
│ ├─ elements
│ ├─ patterns
│ ├─ templates
│ ├─ styles
│ ├─ router
│ ├─ utils
│ ├─ assets
│ │ └─ icons
│ ├─ App.vue
│ ├─ ExampleComponent.vue
│ ├─ main.js
│ └─ system.js
├─ docs
│ ├─ utils
│ └─ components
│ ├─ tokens
│ └─ status
├─ config
├─ test
│ └─ unit
├─ build
└─ dist
- Getting Started: How to install and run Vue Design System.
- Terminology: Introduction to the system concepts and its hierarchy.
- Naming of Things: Naming is hard, so it’s good to have clear guidelines.
- Directory Structure: What goes where and why.
-
Working with the System: Concrete examples on how to work with
Tokens
,Elements
,Patterns
andTemplates
. - Editing Living Documentation: How to customize the living system documentation.
- Spacing: A framework for creating a predictable and harmonious spacing.
- Component Status: Clear labels that reflect the state of completion.
- Component QA: How to review new components and keep the quality high.
- Contributing: A set of guidelines for contributing to the system.
- Code of Conduct: By participating you agree to abide by its terms.
- Frequently Asked Questions: How to use icons, how to use font-face, etc.
- Changelog: See releases pafge for the full changelog.