Membangun Laravel Starter Kit yang Reusable untuk Berbagai Jenis Aplikasi Bisnis
Admin HijrahKreativa
Penulis
Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk
Admin HijrahKreativa
Penulis
Berhenti mengulang setup yang sama untuk setiap proyek POS, booking, atau SaaS. Bangun starter kit internal: fondasi yang teruji, fitur yang bisa diaktifkan per proyek, installer interaktif, dan cara mendistribusikan pembaruan.
Developer yang sering mengerjakan aplikasi bisnis akan merasakan pola yang sama di setiap proyek baru. Dua hari pertama habis untuk pekerjaan yang identik:
Setiap kali disalin dari proyek sebelumnya, ada yang terlewat, ada bug lama yang ikut terbawa, dan perbaikan di satu proyek tidak pernah sampai ke proyek lain.
Starter kit internal menyelesaikan ini, asalkan dirancang dengan benar: cukup kecil agar tidak memaksakan fitur yang tidak dibutuhkan, dan cukup terstruktur agar pembaruan bisa disebarkan.
Hasil akhir artikel ini:
| Komponen | Versi |
|---|---|
| PHP | 8.4 |
| Laravel | 13.x |
| Laravel Installer | 5.x (composer global require laravel/installer) |
| Node.js | 22 LTS |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
| Git & GitHub | Repository organisasi untuk menyimpan kit |
| Paket | spatie/laravel-permission, spatie/laravel-activitylog ^5, larastan/larastan, pestphp/pest |
Masukkan ke kit hanya hal yang dipakai oleh hampir semua proyek dan jarang berbeda antar proyek.
| Kategori | Masuk kit | Jangan masuk kit |
|---|---|---|
| Autentikasi | Login, reset password, verifikasi email, 2FA | Login sosial spesifik klien |
| Otorisasi | Peran & izin dasar, UI manajemen peran | Struktur peran spesifik bisnis |
| Pengaturan | Nama aplikasi, logo, zona waktu, kontak | Tarif pajak spesifik industri |
| Audit | Activity log + halaman riwayat | — |
| Utilitas | Format Rupiah, tanggal Indonesia, terbilang | Integrasi payment gateway tertentu |
| Kualitas | Pint, Larastan, Pest, CI | — |
| Opsional (flag) | API token, multi-cabang, notifikasi WhatsApp | Modul bisnis (POS, booking) |
Aturan praktis: jika sebuah fitur sudah dipakai di tiga proyek berbeda dengan bentuk yang hampir sama, ia kandidat masuk kit. Jika baru sekali, biarkan di proyek tersebut.
Jangan membangun autentikasi dari nol. Laravel menyediakan starter kit resmi (React, Vue, Svelte, dan Livewire) yang sudah mencakup login, registrasi, reset password, verifikasi email, dan halaman profil.
laravel new hk-business-kit
Pilih frontend yang paling sering Anda pakai (misalnya React dengan Inertia, atau Livewire), database, dan Pest sebagai framework test. Lalu inisialisasi repository:
cd hk-business-kit
git init && git add . && git commit -m "chore: base dari starter kit resmi Laravel"
Komit dasar ini penting: Anda bisa membandingkan perubahan kit terhadap starter kit resmi saat Laravel merilis versi baru.
Pisahkan kode milik kit dari kode yang nanti ditulis per proyek, agar pembaruan kit tidak bentrok dengan pekerjaan proyek:
app/
├── Kit/ ← milik starter kit (jangan diubah di proyek turunan)
│ ├── Settings/
│ ├── Access/
│ ├── Audit/
│ ├── Support/ ← helper Rupiah, tanggal, terbilang
│ ├── Console/InstallCommand.php
│ └── KitServiceProvider.php
├── Models/ ← milik proyek
└── Http/ ← milik proyek
config/kit.php
docs/
├── kit/ ← dokumentasi kit
└── decisions/ ← catatan keputusan arsitektur
Daftarkan provider:
// bootstrap/providers.php
return [
App\Providers\AppServiceProvider::class,
App\Kit\KitServiceProvider::class,
];
Satu file konfigurasi menentukan fitur apa yang aktif:
// config/kit.php
return [
'brand' => [
'name' => env('APP_NAME', 'Aplikasi Bisnis'),
'timezone' => env('APP_TIMEZONE', 'Asia/Jakarta'),
'locale' => 'id',
'currency' => 'IDR',
],
'features' => [
'registration' => env('KIT_REGISTRATION', false), // aplikasi internal biasanya tertutup
'api_tokens' => env('KIT_API_TOKENS', false),
'multi_branch' => env('KIT_MULTI_BRANCH', false),
'activity_log' => env('KIT_ACTIVITY_LOG', true),
'two_factor' => env('KIT_TWO_FACTOR', true),
],
'roles' => [
'super-admin' => ['*'],
'admin' => ['users.*', 'settings.*', 'activity.view'],
'staff' => [],
],
];
// app/Kit/Support/Feature.php
namespace App\Kit\Support;
final class Feature
{
public static function enabled(string $feature): bool
{
return (bool) config("kit.features.{$feature}", false);
}
}
Pemakaian di route dan Blade:
// routes/web.php
use App\Kit\Support\Feature;
if (Feature::enabled('api_tokens')) {
Route::middleware('auth')->get('settings/api-tokens', ApiTokenController::class)->name('api-tokens');
}
@if (\App\Kit\Support\Feature::enabled('multi_branch'))
<x-branch-switcher />
@endif
Flag di sini bersifat per instalasi (dibaca dari konfigurasi). Untuk flag yang berubah saat aplikasi berjalan, misalnya per pengguna atau per tenant, gunakan Laravel Pennant.
composer require spatie/laravel-permission
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
Tambahkan trait ke model User:
use Spatie\Permission\Traits\HasRoles;
class User extends Authenticatable
{
use HasFactory, Notifiable, HasRoles;
}
Seeder yang membaca peran dari config/kit.php dan aman dijalankan berulang:
// database/seeders/KitAccessSeeder.php
namespace Database\Seeders;
use Illuminate\Database\Seeder;
use Spatie\Permission\Models\{Permission, Role};
use Spatie\Permission\PermissionRegistrar;
class KitAccessSeeder extends Seeder
{
private const PERMISSIONS = [
'users.view', 'users.create', 'users.update', 'users.delete',
'settings.view', 'settings.update',
'activity.view',
];
public function run(): void
{
app(PermissionRegistrar::class)->forgetCachedPermissions();
foreach (self::PERMISSIONS as $name) {
Permission::findOrCreate($name, 'web');
}
foreach (config('kit.roles') as $roleName => $patterns) {
$role = Role::findOrCreate($roleName, 'web');
$granted = collect(self::PERMISSIONS)->filter(fn ($p) => collect($patterns)
->contains(fn ($pattern) => \Illuminate\Support\Str::is($pattern, $p)));
$role->syncPermissions($granted);
}
}
}
Beri super-admin akses penuh lewat Gate::before:
// app/Kit/KitServiceProvider.php
use Illuminate\Support\Facades\Gate;
public function boot(): void
{
Gate::before(fn ($user) => $user->hasRole('super-admin') ? true : null);
}
Proyek turunan cukup menambahkan izin dan peran bisnisnya sendiri (misalnya kasir dengan pos.checkout) di seeder proyek, tanpa mengubah seeder kit.
Pengaturan yang diubah admin lewat UI (bukan lewat .env) disimpan di database dan di-cache.
php artisan make:migration create_settings_table
Schema::create('settings', function (Blueprint $table) {
$table->string('key')->primary();
$table->json('value')->nullable();
$table->timestamps();
});
// app/Kit/Settings/Setting.php
namespace App\Kit\Settings;
use Illuminate\Database\Eloquent\Model;
class Setting extends Model
{
protected $primaryKey = 'key';
protected $keyType = 'string';
public $incrementing = false;
protected $fillable = ['key', 'value'];
protected function casts(): array
{
return ['value' => 'json'];
}
}
// app/Kit/Settings/SettingsStore.php
namespace App\Kit\Settings;
use Illuminate\Support\Facades\Cache;
final class SettingsStore
{
private const CACHE_KEY = 'kit.settings';
/** Nilai bawaan; proyek turunan bisa menambah lewat config('kit.settings_defaults') */
private function defaults(): array
{
return array_merge([
'company.name' => config('kit.brand.name'),
'company.address' => null,
'company.phone' => null,
'company.logo' => null,
'invoice.prefix' => 'INV',
'invoice.footer' => 'Terima kasih atas kepercayaan Anda.',
], config('kit.settings_defaults', []));
}
public function all(): array
{
$stored = Cache::rememberForever(self::CACHE_KEY, fn () =>
Setting::pluck('value', 'key')->all());
return array_merge($this->defaults(), $stored);
}
public function get(string $key, mixed $default = null): mixed
{
return $this->all()[$key] ?? $default;
}
public function set(array $values): void
{
foreach ($values as $key => $value) {
Setting::updateOrCreate(['key' => $key], ['value' => $value]);
}
Cache::forget(self::CACHE_KEY);
}
}
// app/Kit/KitServiceProvider.php
public function register(): void
{
$this->app->singleton(SettingsStore::class);
}
// Pemakaian
app(SettingsStore::class)->get('invoice.prefix'); // "INV"
app(SettingsStore::class)->set(['company.name' => 'Toko Berkah']);
Opsional, sediakan helper global di app/Kit/Support/helpers.php (didaftarkan lewat autoload.files di composer.json):
if (! function_exists('setting')) {
function setting(string $key, mixed $default = null): mixed
{
return app(\App\Kit\Settings\SettingsStore::class)->get($key, $default);
}
}
Bila aplikasi berjalan di Laravel Octane,
singletontetap aman di sini karena data diambil dari cache pada setiap pemanggilan, bukan disimpan di properti objek.
Utilitas kecil yang selalu dibutuhkan dan sering ditulis ulang:
// app/Kit/Support/Money.php
namespace App\Kit\Support;
final class Money
{
public static function rupiah(int|float|null $amount, bool $withPrefix = true): string
{
$formatted = number_format((float) $amount, 0, ',', '.');
return $withPrefix ? "Rp {$formatted}" : $formatted;
}
public static function terbilang(int $angka): string
{
$huruf = ['', 'satu', 'dua', 'tiga', 'empat', 'lima', 'enam', 'tujuh', 'delapan', 'sembilan', 'sepuluh', 'sebelas'];
return trim(match (true) {
$angka < 12 => $huruf[$angka],
$angka < 20 => self::terbilang($angka - 10).' belas',
$angka < 100 => self::terbilang(intdiv($angka, 10)).' puluh '.self::terbilang($angka % 10),
$angka < 200 => 'seratus '.self::terbilang($angka - 100),
$angka < 1000 => self::terbilang(intdiv($angka, 100)).' ratus '.self::terbilang($angka % 100),
$angka < 2000 => 'seribu '.self::terbilang($angka - 1000),
$angka < 1_000_000 => self::terbilang(intdiv($angka, 1000)).' ribu '.self::terbilang($angka % 1000),
$angka < 1_000_000_000 => self::terbilang(intdiv($angka, 1_000_000)).' juta '.self::terbilang($angka % 1_000_000),
default => self::terbilang(intdiv($angka, 1_000_000_000)).' miliar '.self::terbilang($angka % 1_000_000_000),
});
}
}
Untuk tanggal, cukup atur locale Carbon di provider kit:
// app/Kit/KitServiceProvider.php
use Carbon\Carbon;
public function boot(): void
{
Carbon::setLocale(config('kit.brand.locale'));
}
now()->translatedFormat('l, d F Y'); // "Senin, 19 Oktober 2026"
Selalu sertakan test untuk utilitas seperti ini, karena satu bug di kit menyebar ke semua proyek:
// tests/Unit/Kit/MoneyTest.php
use App\Kit\Support\Money;
it('memformat rupiah', fn () => expect(Money::rupiah(1250000))->toBe('Rp 1.250.000'));
it('menghasilkan terbilang', function (int $angka, string $hasil) {
expect(Money::terbilang($angka))->toBe($hasil);
})->with([
[11, 'sebelas'],
[115, 'seratus lima belas'],
[1_500, 'seribu lima ratus'],
[2_750_000, 'dua juta tujuh ratus lima puluh ribu'],
]);
Pasang activity log sesuai artikel Soft Delete, Audit Trail, dan Activity Log, lalu buat halaman riwayat bawaan kit yang hanya muncul bila Feature::enabled('activity_log').
Tambahkan endpoint health check untuk monitoring uptime:
// routes/web.php
use Illuminate\Support\Facades\{Cache, DB};
Route::get('/healthz', function () {
$checks = [
'database' => rescue(fn () => DB::select('select 1') !== null, false, report: false),
'cache' => rescue(fn () => Cache::set('healthz', 1, 5) && Cache::get('healthz') === 1, false, report: false),
];
$ok = ! in_array(false, $checks, true);
return response()->json(['status' => $ok ? 'ok' : 'degraded', 'checks' => $checks], $ok ? 200 : 503);
})->name('healthz');
Laravel juga menyediakan route /up bawaan (diatur di bootstrap/app.php). Endpoint /healthz di atas melengkapinya dengan pemeriksaan database dan cache.
Setiap proyek baru cukup menjalankan satu perintah. Gunakan Laravel Prompts untuk tampilan yang ramah. Karena command ini milik kit, buat file-nya langsung di app/Kit/Console/ (bukan lewat make:command, yang menaruh file di app/Console/Commands).
// app/Kit/Console/InstallCommand.php
namespace App\Kit\Console;
use App\Kit\Settings\SettingsStore;
use App\Models\User;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Str;
use function Laravel\Prompts\{confirm, info, multiselect, note, password, spin, text};
class InstallCommand extends Command
{
protected $signature = 'kit:install {--no-interaction-defaults : Pakai nilai bawaan tanpa bertanya}';
protected $description = 'Menyiapkan proyek baru dari starter kit';
public function handle(SettingsStore $settings): int
{
$appName = text('Nama aplikasi', default: config('app.name'), required: true);
$features = multiselect(
label: 'Fitur yang diaktifkan',
options: [
'registration' => 'Registrasi publik',
'api_tokens' => 'Token API',
'multi_branch' => 'Multi-cabang',
'activity_log' => 'Activity log',
'two_factor' => 'Autentikasi dua faktor',
],
default: ['activity_log', 'two_factor'],
);
$this->writeEnv([
'APP_NAME' => "\"{$appName}\"",
'APP_TIMEZONE' => 'Asia/Jakarta',
'KIT_REGISTRATION' => in_array('registration', $features) ? 'true' : 'false',
'KIT_API_TOKENS' => in_array('api_tokens', $features) ? 'true' : 'false',
'KIT_MULTI_BRANCH' => in_array('multi_branch', $features) ? 'true' : 'false',
'KIT_ACTIVITY_LOG' => in_array('activity_log', $features) ? 'true' : 'false',
'KIT_TWO_FACTOR' => in_array('two_factor', $features) ? 'true' : 'false',
]);
spin(fn () => $this->callSilently('migrate', ['--force' => true]), 'Menjalankan migration...');
spin(fn () => $this->callSilently('db:seed', ['--class' => 'KitAccessSeeder', '--force' => true]), 'Menyiapkan peran & izin...');
$settings->set(['company.name' => $appName]);
if (confirm('Buat akun super admin sekarang?', default: true)) {
$email = text('Email super admin', required: true, validate: fn ($v) =>
filter_var($v, FILTER_VALIDATE_EMAIL) ? null : 'Format email tidak valid.');
$pass = password('Password (kosongkan untuk dibuat acak)');
$pass = $pass !== '' ? $pass : Str::password(16);
User::updateOrCreate(['email' => $email], [
'name' => 'Super Admin',
'password' => Hash::make($pass),
'email_verified_at' => now(),
])->syncRoles(['super-admin']);
note("Login: {$email}");
}
$this->callSilently('config:clear');
info("{$appName} siap digunakan. Jalankan `composer run dev` untuk mulai.");
return self::SUCCESS;
}
private function writeEnv(array $values): void
{
$path = base_path('.env');
$env = file_get_contents($path);
foreach ($values as $key => $value) {
$line = "{$key}={$value}";
$env = preg_match("/^{$key}=.*/m", $env)
? preg_replace("/^{$key}=.*/m", $line, $env)
: rtrim($env).PHP_EOL.$line.PHP_EOL;
}
file_put_contents($path, $env);
}
}
Daftarkan command di provider kit:
public function boot(): void
{
if ($this->app->runningInConsole()) {
$this->commands([\App\Kit\Console\InstallCommand::class]);
}
}
Tambahkan variabel KIT_* ke .env.example agar terdokumentasi.
Setiap proyek turunan langsung mewarisi standar yang sama.
composer require --dev larastan/larastan
# phpstan.neon
includes:
- vendor/larastan/larastan/extension.neon
parameters:
paths:
- app
level: 6
// pint.json
{
"preset": "laravel",
"rules": {
"declare_strict_types": false,
"ordered_imports": { "sort_algorithm": "alpha" }
}
}
Skrip Composer agar perintahnya seragam:
"scripts": {
"lint": "pint",
"analyse": "phpstan analyse --memory-limit=1G",
"test": "@php artisan test --parallel",
"check": ["@lint --test", "@analyse", "@test"]
}
GitHub Actions:
# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
check:
runs-on: ubuntu-latest
services:
mysql:
image: mysql:8.4
env:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: testing
ports: ['3306:3306']
options: --health-cmd="mysqladmin ping" --health-interval=10s --health-retries=5
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: '8.4'
extensions: mbstring, intl, pdo_mysql, bcmath
coverage: none
- run: composer install --no-interaction --prefer-dist
- run: cp .env.example .env && php artisan key:generate
- run: composer check
env:
DB_CONNECTION: mysql
DB_HOST: 127.0.0.1
DB_DATABASE: testing
DB_USERNAME: root
DB_PASSWORD: root
Tambahkan juga test arsitektur sederhana agar kode proyek tidak mengubah isi App\Kit secara sembarangan (lihat artikel Strategi Multi-Module Laravel).
Ada dua model distribusi. Pilih sesuai kebutuhan pembaruan.
Model A: Template repository (salin sekali)
Tandai repository kit sebagai Template repository di GitHub, atau publikasikan sebagai paket sehingga bisa dipakai lewat Laravel Installer:
# Dari template GitHub
gh repo create klien-pos --template hijrahkreativa/hk-business-kit --private --clone
# Atau lewat Laravel Installer bila kit tersedia di Packagist / repository Composer Anda
laravel new klien-pos --using=hijrahkreativa/hk-business-kit
Tambahkan skrip pasca-instalasi di composer.json kit:
"scripts": {
"post-create-project-cmd": [
"@php -r \"file_exists('.env') || copy('.env.example', '.env');\"",
"@php artisan key:generate --ansi",
"@php artisan kit:install"
]
}
Kelebihan: sederhana, proyek bebas menyimpang. Kekurangan: perbaikan kit harus disalin manual ke setiap proyek.
Model B: Template tipis + paket inti via Composer
Pindahkan isi app/Kit ke paket terpisah (misalnya hijrahkreativa/kit-core) dengan service provider sendiri. Proyek turunan menginstalnya sebagai dependensi:
// composer.json proyek
"repositories": [
{ "type": "vcs", "url": "git@github.com:hijrahkreativa/kit-core.git" }
],
"require": {
"hijrahkreativa/kit-core": "^1.4"
}
composer update hijrahkreativa/kit-core
Kelebihan: perbaikan keamanan dan bug tersebar lewat composer update. Kekurangan: perlu disiplin versi semantik dan dokumentasi upgrade.
| Model A (template) | Model B (paket inti) | |
|---|---|---|
| Waktu setup | Cepat | Sedang |
| Pembaruan ke proyek lama | Manual | composer update |
| Kebebasan modifikasi | Penuh | Lewat konfigurasi dan extension point |
| Cocok untuk | 1–3 proyek per tahun | Banyak proyek aktif yang dipelihara |
Banyak tim memakai keduanya: template untuk struktur dan konfigurasi awal, paket inti untuk kode yang harus terus diperbarui.
CHANGELOG.md untuk setiap rilis kit.docs/decisions/ agar alasan pemilihan paket dan struktur tidak hilang.| Error / Gejala | Penyebab | Solusi |
|---|---|---|
There is no role named 'super-admin' |
Seeder peran belum dijalankan | Jalankan php artisan db:seed --class=KitAccessSeeder atau kit:install |
| Izin baru tidak berlaku | Cache permission spatie | php artisan permission:cache-reset |
Fitur tetap aktif setelah mengubah .env |
Konfigurasi di-cache | php artisan config:clear (lalu config:cache di production) |
| Pengaturan tidak berubah setelah disimpan | Cache tidak dihapus atau driver cache berbeda antar server | Pastikan Cache::forget() dipanggil, dan semua server memakai cache bersama (Redis) |
Call to undefined function setting() |
File helper tidak terdaftar di autoload | Tambahkan ke autoload.files, jalankan composer dump-autoload |
kit:install gagal menulis .env |
Izin file atau .env belum ada |
Salin dari .env.example, periksa izin folder |
composer require paket kit gagal di proyek |
Repository privat tanpa akses | Tambahkan SSH key / token GitHub, atau gunakan Private Packagist / Satis |
| Bentrok saat menyalin pembaruan kit ke proyek | Proyek mengubah file milik kit | Jangan ubah app/Kit di proyek; perluas lewat konfigurasi, event, atau binding container |
| CI gagal di proyek turunan tetapi lolos di kit | Perbedaan versi PHP atau ekstensi | Samakan matriks PHP dan ekstensi di workflow kit dan proyek |
Keamanan
composer audit, Dependabot), karena celah keamanan di kit berarti celah di semua proyek turunan.Performa
php artisan optimize di skrip deploy, queue worker, dan driver cache yang tepat.Maintainability
app/Kit atau paket inti) dari kode proyek.| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| Laravel Installer | 5.x |
| PHP | 8.4 |
| Node.js | 22 LTS |
| MySQL | 8.4 LTS |
| spatie/laravel-activitylog | 5.x |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |
Sebelumnya
Strategi Multi-Module Laravel: Membangun Aplikasi Besar Tanpa Membuat Kode Berantakan
Berikutnya
Panduan Implementasi Login dan Logout Laravel dengan Praktik Keamanan yang Benar
Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.
Peta jalan arsitektur dari satu server hingga banyak server: tahapan pertumbuhan dan sinyal kapan naik tahap, prinsip yang sebaiknya diterapkan sejak awal (stateless, asinkron, data ber-tenant), read replica, pengelolaan data yang terus tumbuh, degradasi yang anggun saat layanan bermasalah, feature...
Menyiapkan lingkungan uji yang jujur, mengukur satu endpoint dengan ApacheBench, mensimulasikan perilaku pengguna sungguhan dengan k6 (skenario, threshold, autentikasi token), menelusuri penyebab request lambat dengan Telescope, memantau server selama pengujian, serta menulis laporan hasil dan angga...
Bagaimana Octane membuat Laravel lebih cepat dengan mem-boot aplikasi sekali dan menyimpannya di memori, apa yang sebenarnya dipercepat (dan yang tidak), risiko kebocoran state antar-request yang wajib dipahami, cara memeriksa kode agar aman untuk Octane, pemasangan dengan FrankenPHP di production,...
03 Nov 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
HijrahKreativa
Kami balas secepatnya
Masuk dulu untuk chat dengan tim kami. Riwayat chat Anda tersimpan di akun.
Masuk