Awesome
crud-vuetify-structured-template boilerplate
š» A full-featured Vuejs + Vuetify + Great structure project template + API Ready
š It's using latest VueJS 2 and Vuetify 2
VueJS 3 + Vuetify 3 + Vite is coming soon š
Requirements
It's exactly the same as the VueJS projects, basicly you'll need a NodeJS installation. Check the links below out for more details:
- Node with NVM - Script for any ubuntu based distribution
- Install Node.js with NVM
- For Windows users, the NodeJs.org might help
Quick start
$ npm i -g @vue/cli-init
$ vue init huogerac/crud-vuetify-structured-template my-project
$ cd my-project
$ npm install # Or yarn
$ npm run dev # See the package.json / scripts
Note: The npm run dev
will run the api mock and vuejs server,
check the package.json
out for running separeted which one.
Why using this boilerplate ā
- Focus on the business and creating value
- Faster project setup
- Standard project structure organization (easy to scale)
- Easy to remove / rename features
- DRY (I was doing those setup steps over and over again)
- I don't want to be backend API dependent (Faster development using API Mocking)
What's Included š
- VueJS (2) + Vuetify configured
- Page inheritance (Layout)
- Home Task's list
- Create, Update and Delete Task
- Error pages (404, 500)
- Vue Router to be scalable
- API Ready (using Axios)
- API Mock (using json-server)
- Pure components
- Linter + Code style (Prettier)
Structure
āāā apiMock š The sub-project for the API mock
āĀ Ā āāā server
ā db.json š The API data (mock)
āāā public
ā favicon.ico
āāā package.json š Project/Package Manifest
āāā .prettierrc.js š Code Style
āāā .env š Set environment var for development
āāā src
āāā router š #1 App routes
ā āāā index.js
ā āāā tasks.api.js š Routers by context
āāā pages š #2 App pages (App pages/views)
āĀ Ā āāā layouts š Pages bases
ā ā āāā Public.vue
āĀ Ā āāā public š Pages by context
ā āāā 500.vue
ā āāā Home.vue š VueJS "SMART" components
āāā components š #3 VueJS "DUMP" components
āĀ Ā āāā visual š Pure components**
āāā api š #4 API folder
ā āāā index.js
ā āāā tasks.api.js š API endpoints by context
āāā mixins š Anything used cross components
ā āāā ApiResponse.vue
āāā filters š VueJS template filters
ā āāā dateFilter.js
āāā assets
ā āāā some-image.jpg
āāā plugins
āāā vuetify.js
Screenshots
<img src="https://github.com/huogerac/crud-vuetify-structured-template/raw/master/screenshots/page1.png" width="112"> <img src="https://github.com/huogerac/crud-vuetify-structured-template/raw/master/screenshots/page2.png" width="112"> <img src="https://github.com/huogerac/crud-vuetify-structured-template/raw/master/screenshots/page3.png" width="112"> <img src="https://github.com/huogerac/crud-vuetify-structured-template/raw/master/screenshots/page4.png" width="112">
Contribute š
Any help is more than welcome...
- š It could be an Issue
- š» It could be using it and give a feedback
- š It could be a github star
- š¤ It could be a question ( Use the Issues )
- š¤ If you hate this project, feel free to tell us what is wrong with it
Alternatives āļø
- If you know great vuejs project templates, please, add it here