|
1 |
| -<p align="center"> |
2 |
| - <a href="https://vuetifyjs.com"> |
3 |
| - <img src=".github/cover.png" alt="Vuetify starter sample" width="500" /> |
4 |
| - </a> |
5 |
| -</p> |
6 |
| - |
7 |
| -<h3 align="center">Vuetify Starter</h3> |
8 |
| - |
9 |
| -<p align="center"> |
10 |
| - A Vuetify starter kit for a faster and consistent development. |
11 |
| - <br> |
12 |
| - <br> |
13 |
| - <a href="https://vuetifyjs.com"><strong>Vuetify docs</strong></a> |
14 |
| - . |
15 |
| - <a href="https://github.com/themustafaomar/vuetify-starter/issues/new"><strong>Report bug</strong></a> |
16 |
| - · |
17 |
| - <a href="https://github.com/themustafaomar/vuetify-starter"><strong>View demo (coming soon)</strong></a> |
18 |
| - · |
19 |
| - <a href="https://github.com/themustafaomar/vuetify-starter/archive/main.zip"><strong>Download</strong></a> |
20 |
| -</p> |
21 |
| - |
22 |
| -## Features |
23 |
| - |
24 |
| -- Using modern technologies in web-industry such as Vue, Vuetify, Pinia Vite and Composition API. |
25 |
| -- Powerful and feature-rich real-time chat system. |
26 |
| -- Access Control List (ACL) for client-side and server-side. |
27 |
| -- Validation handling for client-side & server-side with zero-configuration. |
28 |
| -- Uploading files has never been easier. |
29 |
| -- A set of powerful abstracted components crafted only for VuetifyStarter. |
30 |
| -- Support for light and dark themes and more. |
31 |
| -- Multiple layouts. |
32 |
| -- Multilingual-ready. |
33 |
| -- Complete authentication system. |
34 |
| -- Complete real-time notifications system. |
35 |
| -- Flexible middleware functionlaity for client-side. |
36 |
| -- Standard ESLint and Prettier config for consistent development. |
37 |
| -- And more are in the way. |
38 |
| -- Diffrent enviroment variables using `.env` and `.env.production` |
39 |
| - |
40 |
| -## Recommended IDE Setup |
41 |
| - |
42 |
| -[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin). |
43 |
| - |
44 |
| -## Customize configuration |
45 |
| - |
46 |
| -See [Vite Configuration Reference](https://vitejs.dev/config/). |
47 |
| - |
48 |
| -## Project Setup |
49 |
| - |
50 |
| -```sh |
51 |
| -npm install |
| 1 | +# Vue Starter |
| 2 | + |
| 3 | +🌟 Welcome to Vue starter! |
| 4 | + |
| 5 | +Explore the world of modern web development with our feature-packed Vue starter project, using cutting-edge technologies like Vue, Vuetify, Pinia, and Vite, it's designed to make your front-end development journey a breeze. |
| 6 | + |
| 7 | +<img src="./.github/cover.gif" /> |
| 8 | + |
| 9 | +## Key Features 🚀 |
| 10 | + |
| 11 | +- Real-Time Chat System: Engage users with a powerful and feature-rich real-time chat system supports chat text and voice messages and typing indicator etc... |
| 12 | +- Real-Time Notifications: The starter has a great real-time notifications system. |
| 13 | +- Widgets: A set of beautiful charts using ChartJs (more coming soon) |
| 14 | +- Access Control List (ACL): Leveraging Laravel's Spatie Permissions, we ensure smooth control on both the client and server sides. |
| 15 | +- Validation Handling: Handle client-side and server-side validations effortlessly with zero-configuration. |
| 16 | +- File Uploads Made Easy: Effortlessly upload files with simplified functionality. |
| 17 | +- Theme Support: Enjoy light and dark theme options for a personalized user experience (in development). |
| 18 | +- Multiple Layouts: Create your custom layouts to suit your application's needs. |
| 19 | +- Multilingual-Ready: The starter has a multilingual-ready support. |
| 20 | +- Complete Authentication System: Ensure security with a comprehensive authentication system. |
| 21 | +- Flexible Middleware Functionality: Flexible middleware functionlaity for client-side using custom callbacks with roles and permissions. |
| 22 | +- Code Quality: Maintain consistency with standard ESLint and Prettier configurations. |
| 23 | +- Environment Variables: Easily manage different environments using .env and .env.production. |
| 24 | + |
| 25 | +⚡ And More to Come! |
| 26 | + |
| 27 | +## Installation |
| 28 | + |
| 29 | +Clone the repository using the following command: |
| 30 | + |
| 31 | +```bash |
| 32 | +git clone [email protected]:themustafaomar/vue-starter.git |
52 | 33 | ```
|
53 | 34 |
|
54 |
| -### Compile and Hot-Reload for Development |
| 35 | +Install the dependencies and run the project using: |
55 | 36 |
|
56 |
| -```sh |
57 |
| -npm run dev |
| 37 | +```bash |
| 38 | +npm i && npm run dev |
58 | 39 | ```
|
59 | 40 |
|
60 |
| -### Compile and Minify for Production |
| 41 | +## Broadcasting Directory |
61 | 42 |
|
62 |
| -```sh |
63 |
| -npm run build |
| 43 | +This project has a server-side part please take a look at the following section |
| 44 | + |
| 45 | +As for broadcasting we're not using laravel webosckets instead, we're using soketi to install soketi please follow the instructions below: |
| 46 | + |
| 47 | +soketi may be easily installed via the NPM CLI: |
| 48 | + |
| 49 | +```bash |
| 50 | +npm install -g @soketi/soketi |
64 | 51 | ```
|
65 | 52 |
|
66 |
| -### Lint with [ESLint](https://eslint.org/) |
| 53 | +Now we can run the websockets server, at your client-side root directory run the following command: |
67 | 54 |
|
68 |
| -```sh |
69 |
| -npm run lint |
| 55 | +```bash |
| 56 | +soketi start --config ./broadcasting/soketi.json |
70 | 57 | ```
|
| 58 | + |
| 59 | +For more information about soketi please visit the offical website: https://soketi.app/ |
| 60 | + |
| 61 | +**Notice** that you can still using the laravel websockets but you will need to install it by your own on the server-side project. |
| 62 | + |
| 63 | +## Server Side |
| 64 | + |
| 65 | +For the server-side source code please visit: https://github.com/themustafaomar/vue-starter-server |
| 66 | + |
| 67 | +## Licence |
| 68 | + |
| 69 | +Vue starter project licensed under MIT. |
0 commit comments