Skip to content

Commit d7bbdd7

Browse files
refactor: clean up and update readme
1 parent 8a48406 commit d7bbdd7

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+626
-883
lines changed

.github/cover.gif

376 KB
Loading

README.md

Lines changed: 59 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,69 @@
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
5233
```
5334

54-
### Compile and Hot-Reload for Development
35+
Install the dependencies and run the project using:
5536

56-
```sh
57-
npm run dev
37+
```bash
38+
npm i && npm run dev
5839
```
5940

60-
### Compile and Minify for Production
41+
## Broadcasting Directory
6142

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
6451
```
6552

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:
6754

68-
```sh
69-
npm run lint
55+
```bash
56+
soketi start --config ./broadcasting/soketi.json
7057
```
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

Comments
 (0)