robtesch / primevue-starter-kit
The skeleton application for the Laravel framework.
Installs: 4
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 209
Language:Vue
Type:project
Requires
- php: ^8.2
- inertiajs/inertia-laravel: ^2.0
- laravel/framework: ^12.0
- laravel/tinker: ^2.10.1
- tightenco/ziggy: ^2.4
Requires (Dev)
- fakerphp/faker: ^1.23
- laravel/pail: ^1.2.2
- laravel/pint: ^1.18
- laravel/sail: ^1.41
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.6
- phpunit/phpunit: ^11.5.3
README
Introduction
This is a starter kit for Laravel that uses Vue.js and PrimeVue. It is a fork of the official Laravel Vue Starter Kit.
The key difference is that this starter kit uses PrimeVue as the component library instead of shadcn-vue.
Removed Customization
Please note that this starter kit has removed some of the layout and theme customization options available in the original. It is configured to use a sidebar layout by default.
Our Vue starter kit provides a robust, modern starting point for building Laravel applications with a Vue frontend using Inertia.
Inertia allows you to build modern, single-page Vue applications using classic server-side routing and controllers. This lets you enjoy the frontend power of Vue combined with the incredible backend productivity of Laravel and lightning-fast Vite compilation.
This Vue starter kit utilizes Vue 3 and the Composition API, TypeScript, Tailwind, and the PrimeVue component library.
Getting Started
Frontend Customization
This starter kit is designed to be easily customizable. Here are some of the ways you can tailor it to your needs:
Theming
The project uses a custom PrimeVue theme called "Noir," which is a modified version of the "Aura" theme. You can customize the color scheme by editing resources/js/theme.ts.
The useAppearance composable (resources/js/composables/useAppearance.ts) handles switching between light and dark modes, and storing the user's preference in local storage. You can modify this file to change how the theme is managed.
For more information on PrimeVue theming, see the official documentation.
Sidebar
The useSidebar composable (resources/js/composables/useSidebar.ts) manages the sidebar's state (open/closed) and provides a keyboard shortcut (Ctrl+B) to toggle it. You can adjust the sidebar's width and other properties in this file.
Components
You can add or modify Vue components in the resources/js/components directory. These components can then be used in your pages.
Official Documentation
Documentation for all Laravel starter kits can be found on the Laravel website.
Contributing
Thank you for considering contributing to our starter kit! The contribution guide can be found in the Laravel documentation.
Code of Conduct
In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.
License
The Laravel + Vue starter kit is open-sourced software licensed under the MIT license.