timedoor/baskito

Laravel Starter Kit with InertiaJS and Vue 3


README

About Baskito

Baskito stands for Backend Starter Kit Task Force that Timedoor Backend Developer built to improve development time for the admin page with a standardized tech stack and components built on Laravel 9 :

Prerequisites

Before starting a Baskito project, you need to install this program on your computer to match the Baskito tech stack.

  • php : ^8.0.2 docs
  • composer : ^2.0.0 docs
  • nodejs : ^16.0.0 docs

Dependencies

Besides the package that is already built-in with Laravel, here's the list of installed dependencies within this project.

PHP

  • inertiajs/inertia-laravel : ^0.6.4 docs
  • innocenzi/laravel-vite: 0.2.* docs
  • laravel/ui: ^4.1 docs
  • tightenco/ziggy: ^1.5 docs
  • barryvdh/laravel-debugbar: ^3.7 docs

Javascript

  • @types/bootstrap: ^5.2.6 docs
  • @types/jquery: ^3.5.14 docs
  • @types/ziggy-js: ^1.3.2 docs
  • @types/select2: ^4.0.56 docs
  • @typescript-eslint/eslint-plugin: ^5.46.1 docs
  • @typescript-eslint/parser: ^5.46.1 docs
  • @vitejs/plugin-vue: ^3.2.0 docs
  • @vue/compiler-sfc: ^3.2.45 docs
  • eslint: ^8.29.0 docs
  • eslint-config-prettier: ^8.5.0 docs
  • eslint-plugin-vue: ^9.8.0 docs
  • prettier: ^2.8.1 docs
  • sass: ^1.56.1 docs
  • vite: ^3.2.5 docs
  • vite-plugin-laravel: ^3.2.5 docs
  • vue-eslint-parser: ^9.1.0 docs
  • @inertiajs/inertia: ^0.11.1 docs
  • @inertiajs/inertia-vue3: ^0.6.0 docs
  • @inertiajs/progress: ^0.2.7 docs
  • vue: ^3.2.36 docs
  • ziggy-js: ^1.5.0 docs

Installation

PHP

First, you need to install all PHP package requirements.

composer install

Copy and paste the .env.example file into .env this project and generate APP_KEY.

cp .env.example .env

php artisan key:generate

Create and set your database configuration in the .env file then run the database migration and seeder.

php artisan migrate --seed

Javascript

Install Javascript package dependencies.

npm install

Run Vite for development.

npm run dev

Build Vite.

npm run build

Settings

Vite

Set DEV_SERVER_URL setting in .env to match your local project URL and add a port for Vite to it.

DEV_SERVER_URL=http://baskito.test:4000

Vite SSL

If you use HTTPS for DEV_SERVER_URL while using Laragon that is not placed in the default folder (C:\laragon) or somehow have an SSL error, you must specify the SSL key and certificate file path in the DEV_SERVER_KEY and DEV_SERVER_CERT settings in the .env.

DEV_SERVER_KEY="D:\\laragon\\etc\\ssl\\laragon.key"
DEV_SERVER_CERT="D:\\laragon\\etc\\ssl\\laragon.crt"