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 :

• Laravel 9
• Vue 3
• Inertia
• Bootstrap 4
• Stisla

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"