Installation #
You can create a new project or integrate Vuestic UI into an existing application. There are three ways to create new Vuestic App. All of them mostly the same and provides the same features.
Create Vuestic #
create-vuestic
is CLI based tool to create new Vuestic App. This is a recommended way to scaffold new Vue apps with Vuestic.
npm create vuestic@latest
create-vuestic
provides three template: Vuestic Admin, create-vue and Nuxt. Templates can be configured to use specific features like tree-shaking or AG Grid theme.
Vue CLI installation #
If you have app based on Vue CLI this is a way to install Vuestic UI. Works fine with vite or webpack. Prefer create-vuestic
for new projects
Installing Vuestic UI via the plugin would modify your package.json
and main.(js
|ts)
files, so make sure youโve committed your code before proceeding to avoid data loss.
First, make sure you've got Vue CLI installed globally:
vue --version
Notice also that the minimum supported version of Vue CLI is v4.0.0. In case you've got an older version installed, please, consider upgrading it.
If everything's fine then you can finally install the plugin with the following command (don't forget to commit):
vue add vuestic-ui
Manual installation #
If you decide to install Vuestic UI manually, all you need to do is to install a NPM package, a couple of other necessary assets (such as fonts and CSS styles) and slightly modify your application's entry point (most probably index.js
or main.js
, depending on your setup).
But first, make sure you've got all the following prerequisites installed:
After checking the prerequisites, install Vuestic UI via npm or yarn:
npm install vuestic-ui
Assets installation #
By default Vuestic UI uses Source Sans Pro
and Material Icons
fonts. You should manually add them into your project. In order to do so you can either:
include fonts directly in your index.html
's <head>
element
<link
href="https://fonts.googleapis.com/css2?family=Source+Sans+Pro:ital,wght@0,400;1,700&display=swap"
rel="stylesheet"
/>
<link
href="https://fonts.googleapis.com/icon?family=Material+Icons"
rel="stylesheet"
/>
or include them in your CSS
@import url("https://fonts.googleapis.com/css2?family=Source+Sans+Pro:ital,wght@0,400;1,700&display=swap");@import url("https://fonts.googleapis.com/icon?family=Material+Icons");
Modify your application's entry point #
Import both the styles and the plugin into your entry file. The plugin is used to automatically register all the components, directives and other stuff globally. If you don't want to register everything globally then check out the tree-shaking section below.
// main.js
import { createApp } from "vue";
import App from "./App.vue";
import { createVuestic } from "vuestic-ui";
import "vuestic-ui/css";
createApp(App).use(createVuestic()).mount("#app");