# Vue Frontend Setup
To start using this design system you will need to to install some dependencies or copy some files to your project.
# Steps to install
- Navigate to your Vue Black Dashboard project folder:
- Install project dependencies:
- Create a new .env file:
cp .env.example .env
VUE_APP_BASE_URLshould contain the URL of your Vue Black Dashboard Project (eg. http://localhost:8080/)
VUE_APP_API_BASE_URLshould contain the URL of your Laravel JSON:API Project. (eg. http://localhost:3000/api/v1)
npm run devto start the application in a local development environment or
npm run buildto build release distributables.
# 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/blackDashboard' Vue.use(DashboardPlugin);
# Global Components
Black 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:
# 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 Black Kit, they should be imported locally.
Here's the list of local components:
# 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";