diff --git a/CHANGELOG.md b/CHANGELOG.md index f6b9120..7c9c398 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,26 +1,4 @@ # Change Log -## [1.0.0] 2017-06-18 +## [1.0.0] 2018-10-14 ### Stable Original Release - -## [2.0.0] 2018-05-01 -## Vue Paper Dashboard Version 2 -- Bootstrap 4 update - - Migrate components to support BS4 as well as existing scss assets -- Vue CLI 3 update - - Get rid of old webpack template and make use of newest vue-cli 3. The project has almost no configuration files and - should work out of the box if you copy paste the `src` folder into a newly scaffolded Vue CLI 3 project. -- Overall project structure improvements - - The project structure resembles a default [nuxt project structure](https://nuxtjs.org/) - We have a breakdown of - - `components` folder (only UI components) - - `pages` folder which contains pages/views - - `layout` folder which contains layout related components - - `assets` folder which contains scss, images and fonts - - `plugins` folder which has project related plugins - - `router` folder which contains routes - -- Component improvements - - Use of `vue-notifyjs` for notifications - - Improvements for Sidebar. Option to declare links as children inside Sidebar slot. SSR support. - - Minor improvements for other components and SSR support for them diff --git a/LICENSE.md b/LICENSE.md index 519c91e..73164ce 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2017 Cristi Jora +Copyright (c) 2017 Creative Tim (https://www.creative-tim.com) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index 3f7bf3f..7c358c3 100644 --- a/README.md +++ b/README.md @@ -1,45 +1,211 @@ -# [Vue Black Dashboard](https://github.com/creativetimofficial/vue-black-dashboard) +# [Vue-Black Dashboard](https://demos.creative-tim.com/vue-black-dashboard) [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social&logo=twitter)](https://twitter.com/intent/tweet?text=Black%20Dashboard%20by%20Creative%20Tim&url=https%3A%2F%2Fdemos.creative-tim.com%2Fblack-dashboard%2Fexamples%2Fdashboard.html&via=CreativeTim) -> Admin dashboard based on black dashboard UI template + vue-router -This project is a vue version of [Black-dashboard](https://www.creative-tim.com/product/paper-dashboard) -designed for vue js.The dashboard includes vue-router + ![version](https://img.shields.io/badge/version-1.0.0-blue.svg) ![license](https://img.shields.io/badge/license-MIT-blue.svg) [![GitHub issues open](https://img.shields.io/github/issues/creativetimofficial/black-dashboard/issues.svg?maxAge=2592000)](https://github.com/creativetimofficial/black-dashboard/issues/issues?q=is%3Aopen+is%3Aissue) [![GitHub issues closed](https://img.shields.io/github/issues-closed-raw/creativetimofficial/black-dashboard/issues.svg?maxAge=2592000)](https://github.com/creativetimofficial/black-dashboard/issues/issues?q=is%3Aissue+is%3Aclosed) [![Join the chat at https://gitter.im/NIT-dgp/General](https://badges.gitter.im/NIT-dgp/General.svg)](https://gitter.im/creative-tim-general/Lobby) [![Chat](https://img.shields.io/badge/chat-on%20discord-7289da.svg)](https://discord.gg/E4aHAQy) -Check the [Live Demo here](https://github.com/creativetimofficial/vue-black-dashboard). + +![Product Gif](https://s3.amazonaws.com/creativetim_bucket/github/gif/vue-black-dashboard.gif) + +Vue Black Dashboard is a beautiful Bootstrap 4 Admin Dashboard with a huge number of components built to fit together and look amazing. If you are looking for a tool to manage and visualize data about your business, this dashboard is the thing for you. It combines colors that are easy on the eye, spacious cards, beautiful typography, and graphics. +Vue Black Dashboard comes packed with all plugins that you might need inside a project and documentation on how to get started. It is light and easy to use, and also very powerful. + +Vue Black Dashboard features over 16 individual components, giving you the freedom of choosing and combining. This means that there are thousands of possible combinations. All components can take variations in color, that you can easily modify using SASS files. You will save a lot of time going from prototyping to full-functional code because all elements are implemented. +We thought about everything, so this dashboard comes with 2 versions, Dark Mode and Light Mode. + +We are very excited to share this dashboard with you and we look forward to hearing your feedback! + + +## Table of Contents + + +* [Demo](#demo) +* [Quick Start](#quick-start) +* [Documentation](#documentation) +* [File Structure](#file-structure) +* [Browser Support](#browser-support) +* [Resources](#resources) +* [Reporting Issues](#reporting-issues) +* [Technical Support or Questions](#technical-support-or-questions) +* [Licensing](#licensing) +* [Useful Links](#useful-links) + + +## Demo + +- [Start page](https://demos.creative-tim.com/vue-black-dashboard) +- [User profile page](https://demos.creative-tim.com/vue-black-dashboard/#/profile) +- [Tables page ](https://demos.creative-tim.com/vue-black-dashboard/#/table-list) +- [Maps Page](https://demos.creative-tim.com/vue-black-dashboard/#/maps) +- [Notifications page](https://demos.creative-tim.com//vue-black-dashboard/#/notifications) + +[View More](https://demos.creative-tim.com/vue-black-dashboard). + + +## Quick start + +- Clone the repo: `git clone https://github.com/creativetimofficial/vue-black-dashboard.git`. +- [Download from Github](https://github.com/creativetimofficial/vue-black-dashboard/archive/master.zip). +- [Download from Creative Tim](https://www.creative-tim.com/product/vue-black-dashboard). ## Documentation -Link to [Documentation](http://vuejs.creative-tim.com/vue-black-dashboard/documentation/) +The documentation for the Vue Black Dashboard is hosted at our [website](https://demos.creative-tim.com/vue-black-dashboard/documentation). -## Build Setup -### install dependencies -``` -npm install -``` -### serve with hot reload at localhost:8080 -``` -npm run dev -``` -### build for production with minification -``` -npm run build -``` -### lint -``` -npm run lint -``` -## Contribution guide -* Fork the repository -* `npm install` or `yarn install` -* Make changes -* Open Pull Request +## File Structure +Within the download you'll find the following directories and files: -For detailed explanation on how things work, checkout the [guide](https://github.com/vuejs/vue-cli/blob/dev/docs/README.md) -- [CHANGELOG](./CHANGELOG.md) -- [version-badge](https://img.shields.io/badge/version-2.0.0-blue.svg) -- [license-badge](https://img.shields.io/badge/license-MIT-blue.svg) +``` +|-- Vue Black Dashboard + |-- .babelrc + |-- .env + |-- .eslintrc + |-- .gitattributes + |-- .gitignore + |-- CHANGELOG.md + |-- CONTRIBUTING.md + |-- LICENSE.md + |-- README.md + |-- package.json + |-- vue.config.js + |-- src + |-- App.vue + |-- i18n.js + |-- main.js + |-- assets + | |-- css + | | |-- nucleo-icons.css + | |-- demo + | | |-- demo.css + | |-- fonts + | | |-- nucleo.eot + | | |-- nucleo.ttf + | | |-- nucleo.woff + | | |-- nucleo.woff2 + | |-- sass + | |-- black-dashboard.scss + | |-- black-dashboard + | |-- bootstrap + | |-- custom + | |-- plugins + |-- components + | |-- BaseAlert.vue + | |-- BaseButton.vue + | |-- BaseCheckbox.vue + | |-- BaseDropdown.vue + | |-- BaseNav.vue + | |-- BaseTable.vue + | |-- CloseButton.vue + | |-- Modal.vue + | |-- NavbarToggleButton.vue + | |-- index.js + | |-- Cards + | | |-- Card.vue + | | |-- StatsCard.vue + | |-- Charts + | | |-- BarChart.js + | | |-- LineChart.js + | | |-- config.js + | | |-- utils.js + | |-- Inputs + | | |-- BaseInput.vue + | |-- NotificationPlugin + | | |-- Notification.vue + | | |-- Notifications.vue + | | |-- index.js + | |-- SidebarPlugin + | |-- SideBar.vue + | |-- SidebarLink.vue + | |-- index.js + |-- directives + | |-- click-ouside.js + |-- layout + | |-- dashboard + | |-- Content.vue + | |-- ContentFooter.vue + | |-- DashboardLayout.vue + | |-- MobileMenu.vue + | |-- SidebarSharePlugin.vue + | |-- TopNavbar.vue + |-- locales + | |-- ar.json + | |-- en.json + |-- pages + | |-- Dashboard.vue + | |-- Icons.vue + | |-- Maps.vue + | |-- NotFoundPage.vue + | |-- Notifications.vue + | |-- Profile.vue + | |-- TableList.vue + | |-- Typography.vue + | |-- Dashboard + | | |-- TaskList.vue + | | |-- UserTable.vue + | |-- Notifications + | | |-- NotificationTemplate.vue + | |-- Profile + | |-- EditProfileForm.vue + | |-- UserCard.vue + |-- plugins + | |-- RTLPlugin.js + | |-- blackDashboard.js + | |-- globalComponents.js + | |-- globalDirectives.js + | |-- liveDemo.js + |-- router + |-- index.js + |-- routes.js -## License +``` + + +## Browser Support + +At present, we officially aim to support the last two versions of the following browsers: + + + + + +## Reporting Issues + +We use GitHub Issues as the official bug tracker for the Vue Black Dashboard. Here are some advices for our users that want to report an issue: + +1. Make sure that you are using the latest version of the Vue Black Dashboard. Check the CHANGELOG from your dashboard on our [website](https://www.creative-tim.com/). +2. Providing us reproducible steps for the issue will shorten the time it takes for it to be fixed. +3. Some issues may be browser specific, so specifying in what browser you encountered the issue might help. + + +## Technical Support or Questions + +If you have questions or need help integrating the product please [contact us](https://www.creative-tim.com/contact-us) instead of opening an issue. + + +## Licensing + +- Copyright 2018 Creative Tim (https://www.creative-tim.com/) + +- Licensed under MIT (https://github.com/creativetimofficial/vue-black-dashboard/issues/blob/master/LICENSE.md) + + + +## Useful Links + +- [More products](https://www.creative-tim.com/bootstrap-themes) from Creative Tim +- [Tutorials](https://www.youtube.com/channel/UCVyTG4sCw-rOvB9oHkzZD1w) +- [Freebies](https://www.creative-tim.com/bootstrap-themes/free) from Creative Tim +- [Affiliate Program](https://www.creative-tim.com/affiliates/new) (earn money) + +##### Social Media + +Twitter: + +Facebook: + +Dribbble: + +Google+: + +Instagram: -[MIT](https://github.com/creativetimofficial/vue-black-dashboard/LICENCE.md) diff --git a/src/assets/demo/product-gif.gif b/src/assets/demo/product-gif.gif new file mode 100644 index 0000000..893b791 Binary files /dev/null and b/src/assets/demo/product-gif.gif differ