|
| 1 | +# Vuetify (Default) |
| 2 | + |
| 3 | +This is the official scaffolding tool for Vuetify, designed to give you a head start in building your new Vuetify application. It sets up a base template with all the necessary configurations and standard directory structure, enabling you to begin development without the hassle of setting up the project from scratch. |
| 4 | + |
| 5 | +## ❗️ Important Links |
| 6 | + |
| 7 | +- 📄 [Docs](https://vuetifyjs.com/) |
| 8 | +- 🚨 [Issues](https://issues.vuetifyjs.com/) |
| 9 | +- 🏬 [Store](https://store.vuetifyjs.com/) |
| 10 | +- 🎮 [Playground](https://play.vuetifyjs.com/) |
| 11 | +- 💬 [Discord](https://community.vuetifyjs.com) |
| 12 | + |
| 13 | +## 💿 Install |
| 14 | + |
| 15 | +Set up your project using your preferred package manager. Use the corresponding command to install the dependencies: |
| 16 | + |
| 17 | +| Package Manager | Command | |
| 18 | +|---------------------------------------------------------------|----------------| |
| 19 | +| [yarn](https://yarnpkg.com/getting-started) | `yarn install` | |
| 20 | +| [npm](https://docs.npmjs.com/cli/v7/commands/npm-install) | `npm install` | |
| 21 | +| [pnpm](https://pnpm.io/installation) | `pnpm install` | |
| 22 | +| [bun](https://bun.sh/#getting-started) | `bun install` | |
| 23 | + |
| 24 | +After completing the installation, your environment is ready for Vuetify development. |
| 25 | + |
| 26 | +## ✨ Features |
| 27 | + |
| 28 | +- 🖼️ **Optimized Front-End Stack**: Leverage the latest Vue 3 and Vuetify 3 for a modern, reactive UI development experience. [Vue 3](https://v3.vuejs.org/) | [Vuetify 3](https://vuetifyjs.com/en/) |
| 29 | +- 🗃️ **State Management**: Integrated with [Pinia](https://pinia.vuejs.org/), the intuitive, modular state management solution for Vue. |
| 30 | +- 🚦 **Routing and Layouts**: Utilizes Vue Router for SPA navigation and vite-plugin-vue-layouts for organizing Vue file layouts. [Vue Router](https://router.vuejs.org/) | [vite-plugin-vue-layouts](https://github.com/JohnCampionJr/vite-plugin-vue-layouts) |
| 31 | +- ⚡ **Next-Gen Tooling**: Powered by Vite, experience fast cold starts and instant HMR (Hot Module Replacement). [Vite](https://vitejs.dev/) |
| 32 | +- 🧩 **Automated Component Importing**: Streamline your workflow with unplugin-vue-components, automatically importing components as you use them. [unplugin-vue-components](https://github.com/antfu/unplugin-vue-components) |
| 33 | + |
| 34 | +These features are curated to provide a seamless development experience from setup to deployment, ensuring that your Vuetify application is both powerful and maintainable. |
| 35 | + |
| 36 | +## 💡 Usage |
| 37 | + |
| 38 | +This section covers how to start the development server and build your project for production. |
| 39 | + |
| 40 | +### Starting the Development Server |
| 41 | + |
| 42 | +To start the development server with hot-reload, run the following command. The server will be accessible at [http://localhost:3000](http://localhost:3000): |
| 43 | + |
| 44 | +```bash |
| 45 | +yarn dev |
| 46 | +``` |
| 47 | + |
| 48 | +(Repeat for npm, pnpm, and bun with respective commands.) |
| 49 | + |
| 50 | +> Add NODE_OPTIONS='--no-warnings' to suppress the JSON import warnings that happen as part of the Vuetify import mapping. If you are on Node [v21.3.0](https://nodejs.org/en/blog/release/v21.3.0) or higher, you can change this to NODE_OPTIONS='--disable-warning=5401'. If you don't mind the warning, you can remove this from your package.json dev script. |
| 51 | +
|
| 52 | +### Building for Production |
| 53 | + |
| 54 | +To build your project for production, use: |
| 55 | + |
| 56 | +```bash |
| 57 | +yarn build |
| 58 | +``` |
| 59 | + |
| 60 | +(Repeat for npm, pnpm, and bun with respective commands.) |
| 61 | + |
| 62 | +Once the build process is completed, your application will be ready for deployment in a production environment. |
| 63 | + |
| 64 | +## 💪 Support Vuetify Development |
| 65 | + |
| 66 | +This project is built with [Vuetify](https://vuetifyjs.com/en/), a UI Library with a comprehensive collection of Vue components. Vuetify is an MIT licensed Open Source project that has been made possible due to the generous contributions by our [sponsors and backers](https://vuetifyjs.com/introduction/sponsors-and-backers/). If you are interested in supporting this project, please consider: |
| 67 | + |
| 68 | +- [Requesting Enterprise Support](https://support.vuetifyjs.com/) |
| 69 | +- [Sponsoring John on Github](https://github.com/users/johnleider/sponsorship) |
| 70 | +- [Sponsoring Kael on Github](https://github.com/users/kaelwd/sponsorship) |
| 71 | +- [Supporting the team on Open Collective](https://opencollective.com/vuetify) |
| 72 | +- [Becoming a sponsor on Patreon](https://www.patreon.com/vuetify) |
| 73 | +- [Becoming a subscriber on Tidelift](https://tidelift.com/subscription/npm/vuetify) |
| 74 | +- [Making a one-time donation with Paypal](https://paypal.me/vuetify) |
| 75 | + |
| 76 | +## 📑 License |
| 77 | +[MIT](http://opensource.org/licenses/MIT) |
| 78 | + |
| 79 | +Copyright (c) 2016-present Vuetify, LLC |
0 commit comments