# Quick Start
To start using this design system you will need to to install some dependencies or copy some files to your project.
# Steps to install
- Make sure you have Node.js installed.
- Navigate to the main directory (from terminal) where
package.json
is located. - Run
npm install
oryarn install
- Run
npm run serve
oryarn serve
to start the local development server and start prototyping.
# Vue Black Dashboard
Vue Black Dashboard is built as Vue plugin so you can simply import it and use it.
import Vue from 'vue';
import DashboardPlugin from '@/plugins/dashboard-plugins'
Vue.use(DashboardPlugin);
# Changing mode
Vue Black Dashboard PRO comes with 2 pre-build modes and looks: dark and white.
Dark mode is the default mode. If you want to switch to white mode, simply add the white-content
class to the body
inside public/index.html
file
<body class="sidebar-mini white-content">
<div class="wrapper" id="app">
</body>
You could also toggle the mode dynamically from the code with this piece of code:
document.body.classList.toggle('white-content');
# Global Components
Argon comes with an extensive set of custom Vue components. Some of them are globally instantiated so it's easier to use them across the app without importing them each time.
Here's the list of global components:
- BaseButton
- BaseCheckbox
- BaseDropdown
- Card
- BaseInput
# Local components
Besides the components mentioned above, we have some extra components/plugins that are usually less used and bigger. In order to not affect the overall bundle size of the Argon Kit, they should be imported locally.
Here's the list of local components (which are not global):
|-- AnimatedNumber.vue
|-- Badge.vue
|-- BaseAlert.vue
|-- BaseNav.vue
|-- BasePagination.vue
|-- BaseProgress.vue
|-- BaseRadio.vue
|-- BaseSwitch.vue
|-- BaseTable.vue
|-- CloseButton.vue
|-- ImageUpload.vue
|-- LoadingPanel.vue
|-- Modal.vue
|-- NavbarToggleButton.vue
|-- Slider.vue
|-- Breadcrumb
| |-- Breadcrumb.vue
| |-- BreadcrumbItem.vue
| |-- RouteBreadcrumb.vue
|-- Cards
| |-- StatsCard.vue
|-- Charts
| |-- BarChart.js
| |-- LineChart.js
| |-- PieChart.js
|-- Collapse
| |-- Collapse.vue
| |-- CollapseItem.vue
|-- Inputs
| |-- BaseCheckbox.vue
| |-- BaseRadio.vue
| |-- IconCheckbox.vue
|-- Navbar
| |-- Navbar.vue
| |-- NavbarToggleButton.vue
|-- NotificationPlugin
| |-- Notification.vue
| |-- Notifications.vue
|-- SidebarPlugin
| |-- SideBar.vue
| |-- SidebarItem.vue
|-- Tabs
| |-- Tab.vue
| |-- Tabs.vue
|-- Timeline
| |-- TimeLine.vue
| |-- TimeLineItem.vue
|-- Wizard
| |-- Wizard.vue
| |-- WizardTab.vue
|-- WorldMap
|-- AsyncWorldMap.vue
|-- WorldMap.vue
# Starter template
To get started faster, we provide a starter template inside the project. It's a bare bones layout with nav, footer and a hello world. To enable it go to main.js and change line 3
import Vue from "vue";
import App from "./App.vue";
import router from "./starterRouter";