Kurulum #

Bu rehber, sıfır bir proje için önerilen kurulum akışını anlatır.

Boş bir Laravel kurulumundan başlayın. Bu paketi kurmadan önce php artisan install:inertia, install:api, Breeze, Jetstream veya başka bir starter preset çalıştırmayın. Preset'ler bu starter kit'in de yayınladığı controller, route, sayfa ve layout'ları oluşturur — installer bunları tespit edemediği için kit'in kendi dosyalarının yanında yetim "ölü kod" olarak kalırlar.

Önerilen akış:

composer create-project laravel/laravel my-app
cd my-app
composer require lvntr/laravel-starter-kit:^13.7
php artisan sk:install

Başlamadan önce php -v çıktısının 8.4 veya üzeri olduğunu doğrulayın. composer create-project laravel/laravel yalnızca PHP 8.3 ister; bu yüzden 8.3'te sorunsuz tamamlanır ve sizi bu kit'in tabanının bir adım altında bırakır. Paketi gevşek bir :^13.0 yerine :^13.7 ile ekleyin — gevşek constraint, Composer'ın gerçek engeli bildirmek yerine PHP 8.3'e uyan eski bir sürümü sessizce kurmasına yol açar (ardından composer update "nothing to update" der). Kurulum beklenmedik bir sürüme düşerse composer why-not lvntr/laravel-starter-kit 13.7.0 komutu engeli gösterir.

Gereksinimler #

1. Projeyi Hazırlayın #

Başlamadan önce projede çalışan bir veritabanı bağlantısı ve geçerli bir .env dosyası olduğundan emin olun. Temel ayarları önceden girin:

APP_NAME="Uygulamam"
APP_URL=https://uygulamam.test

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=uygulamam
DB_USERNAME=root
DB_PASSWORD=

Dikkat Edilmesi Gereken Env Değişkenleri #

Installer, yeni kurulumların gözden geçirmesi gereken birkaç anahtar taşıyan başlangıç .env.example yazar:

# Timestamp saklama UTC olarak kalmalıdır. Sitenin gösterim fallback'i için
# APP_DISPLAY_TIMEZONE kullanın; kullanıcılar profilinden override edebilir.
APP_TIMEZONE=UTC
APP_DISPLAY_TIMEZONE=UTC

# Log seviyesi — local dev için 'debug' uygundur; production 'error' veya 'warning' göndermeli.
LOG_LEVEL=error

# Route adından izni türetilemeyen bir isteği controller'a gate'siz ulaştırmak
# yerine reddeder. YENİ bir proje için bilerek false yazılır: geriye dönük
# korunması gereken eski bir route yoktur, dolayısıyla gate'siz kalan bir
# route'unuz production'da değil geliştirme sırasında yakalanır.
STARTER_KIT_ALLOW_UNRESOLVED_ROUTES=false

# Cloudflare Turnstile (bot / captcha). TURNSTILE_ENABLED=false iken
# `turnstile` middleware'i no-op olduğu için lokal olarak anahtarları boş bırakmak güvenli.
TURNSTILE_ENABLED=false
TURNSTILE_SITE_KEY=
TURNSTILE_SECRET_KEY=

# Session sertleştirme — ikisinin de default'u 'true'. Production'da açık tutun.
SESSION_ENCRYPT=true
SESSION_SECURE_COOKIE=true

# APP_KEY'den bağımsız, hassas ayarlar (settings.value) ve 2FA secret'ları için
# adanmış anahtar. `php artisan key:generate` bunlara hiç dokunmaz. İlk kurulumda
# otomatik üretilir; her sunucu taşımasında .env ile birlikte taşınmalıdır
# (bkz. docs/server-migration-runbook.tr.md).
DATA_ENCRYPTION_KEY=
DATA_ENCRYPTION_PREVIOUS_KEYS=

# Passport OAuth2 anahtarları — production için önerilen desen, anahtarları
# storage/oauth-*.key dosyalarına commit etmek yerine env üzerinden yüklemek.
# Bir kez `php artisan passport:keys` çalıştırın, üretilen string'leri bu env
# değişkenlerine taşıyın, sonra dosyaları silin.
# PASSPORT_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
# PASSPORT_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"

STARTER_KIT_ALLOW_UNRESOLVED_ROUTES=false yalnızca yeni bir .env dosyasına yazılır. Paketi güncelleyen mevcut bir uygulama izin veren varsayılanla kalır; hiçbir sürüm bu değeri sizin yerinize çevirmez — bkz. Yükseltme Notları. Temiz kurulumdan sonra bir route'unuz 403 dönmeye başlarsa php artisan sk:doctor --only=unresolved-routes izni türetilemeyen tüm route'ları listeler; route'a resource.action biçiminde bir isim verin, bilerek izinsiz bırakılacaksa config/starter-kit.php içindeki permissions.unrestricted_routes listesine ekleyin ya da düzeltene kadar anahtarı true yapın.

APP_TIMEZONE değerini sitenin bölgesel saat dilimine ayarlamayın: bu değişken Laravel'in saklama saat dilimini yönetir. Bunun yerine APP_DISPLAY_TIMEZONE kullanın veya kurulumdan sonra Ayarlar → Genel bölümünden site fallback'ini seçin. Kullanıcı override'ları ve tam çözüm zinciri için Saat Dilimleri belgesine bakın.

DATA_ENCRYPTION_KEY ve DATA_ENCRYPTION_PREVIOUS_KEYS, hassas ayar değerlerini ve 2FA secret'larını APP_KEY'den bağımsız olarak korur — temiz bir kurulum anahtarı otomatik üretir, herhangi bir işlem gerekmez. Önemli olan bundan sonraki .env disiplinidir: bir sunucu taşıması her iki anahtarı da .env'in geri kalanıyla birlikte taşımalı, php artisan key:generate asla bunun yerine geçmemelidir. Tam anahtar-çözümleme sözleşmesi ve rotasyon komutları için Veri Şifreleme belgesine, yeni bir sunucuya geçmeden önce sunucu taşıma runbook'u'na bakın.

2. Paketi Ekleyin #

composer require lvntr/laravel-starter-kit:^13.7

3. Kurulum Komutunu Çalıştırın #

php artisan sk:install

sk:install bir ilk-kurulum komutudur, onarım aracı değildir. Kit'in henüz kurulmadığı bir projede bir kez çalıştırın. Kurulu bir uygulamada tekrar çalıştırmak güvenli değildir: yayınlama hash-farkındalıklıdır, yani bir dosya — o yolu kurulum sırasında hariç tuttuysanız, paket o dosya için yeni bir şey göndermediyse, yeni bir sürüm var ve siz kendi kopyanızı düzenlediyseniz ya da hash kaydında o dosya için hiç iz yoksa — korunur; yeniden kurulumda kaydın hiç izlemediği bir dosya sizin dosyanız sayılır ve --force verilmedikçe üzerine yazılmak yerine korunup raporlanır. Bu koruma yalnızca ortada bir kayıt varken geçerlidir: gerçek bir ilk kurulumda henüz yetkili bir kayıt olmadığından, kaydı olmayan bir dosya dahil her yol normal şekilde yayınlanır. .env dosyanız asla üzerine yazılmaz. Kayıt, git tarafından yok sayılan storage/starter-kit/hashes.json altında durur; kayıt kaybolursa (stateless bir deploy, temizlenmiş bir storage/ dizini) installer artık uygulamayı ilk kurulum saymaz — uygulamayı kit'in zaten kurulu olduğuna dair kanıt için inceler ve bir kanıt bulursa --force verilmedikçe tek bir bayt bile yazmadan hata ile durur. Bitiremeyen bir çalışma (örneğin ulaşılamayan bir veritabanı) sıfırdan farklı bir çıkış koduyla INCOMPLETE olarak kapanır ve hash kaydını yazmaz; böylece başarılı bir kurulum olarak kaydedilmek yerine sk:install --resume ile devam ettirilebilir kalır. Kurulu bir uygulamayı değiştirmek için sk:update ya da sk:publish --tag=<alan> kullanın.

Herhangi bir dosyaya dokunmadan önce installer bir preflight kontrolü çalıştırır (Node.js sürümü — Node eksikse ya da Vite 7 motor tabanı olan 20.19'dan eskiyse uyarı verir ve npm adımının kendi kendine düşmesine izin verir; asla hard-fail olmaz) ve önceki yarıda kalmış bir çalışmadan checkpoint varsa yükler (storage/starter-kit/install-progress.json). Bir adım hata fırlatırsa installer ham stack trace yerine somut bir mesajla durur ("Step failed: <adım> — sorunu düzelt, sonra sk:install --resume çalıştır"); tamamlanmış adımlar checkpoint'e yazıldığından --resume onları atlayıp kaldığı yerden devam eder. Kurulum başarıyla bitince progress dosyası otomatik silinir.

Sihirbaz ardından her adımda sizinle interaktif olarak ilerler:

config/api-dock.php, config yayınlama adımıyla değil 1. adımdaki scaffolding ile birlikte gelir — /api-dock dokümantasyon paneli için kitin kısıtlı middleware yığınını taşır. Panel ve belgelediği /api/v1 sözleşmesi, seed edilen api-docs.read izninin (varsayılan olarak developer rolüne verilir) arkasındadır; bkz. API Rotaları Admin Modülü.

Config adımında sk:install, config/database.php içindeki mevcut mysql ve mariadb dizilerine literal 'timezone' => '+00:00' sözleşmesini ekler. Consumer'ın tanımladığı bir timezone değerinin üzerine yazmaz, eksik bir bağlantı oluşturmaz; sqlite, pgsql veya sqlsrv bağlantılarına dokunmaz.

Sıfır kurulumlarda veri dönüşümü gerekmez. Consumer sk:install komutunu zaten veri barındıran bir veritabanına yöneltebileceği için, önce varsayılan MySQL/MariaDB bağlantısının UTC dışı bir oturumda veri taşıyıp taşımadığını kontrol eder — taşıyorsa pin adımını atlar ve bu durumu onay kapısıyla ele alan sk:upgrade komutunu, tek seferlik dönüşüm rehberini okuduktan sonra çalıştırmanızı söyler. Ulaşılamayan bir veritabanı sıfır kurulum gibi değerlendirilir ve adımı bloke etmez.

Migration stratejisi seçimi #

Varsayılan bağlantı zaten tablo taşıyorsa, migration adımı nasıl ilerleneceğini sorar:

Prompt açamayan bir oturuma (--no-interaction, CI, TTY yok) yıkıcı dal asla sunulmaz ve onun adına asla seçilmez — yalnızca bekleyen migration'lar çalışır.

Yıkıcı seçenek, aşağıdakilerden herhangi biri geçerliyse tamamen sunulmaz ve gerekçesi ekrana yazılır:

• APP_ENV production'a benziyor;
• APP_DEBUG kapalı, yani uygulama deploy edilmiş sayılıyor;
• oturum onay için prompt açamıyor;
• mevcut herhangi bir tablo zaten satır tutuyor. Bu yoklama fail-closed'dır — okunamayan bir tablo (izin kısıtlı, kimlik bilgilerinin select edemediği bir view, yoklama sırasında düşürülmüş) asla boş değil, canlı veri tutuyor sayılır. migrations defteri hariç tutulur; onun satırları operatörün kaybedebileceği bir veri değildir.

Seçenek sunulduğunda, seçilmesi hâlinde bağlantı ve veritabanı adı yazdırılır ve sizden veritabanı adını (veya fresh kelimesini) yazmanız istenir. Baştaki ve sondaki boşluk affedilir; başka hiçbir şey affedilmez. Boş satır, y, yes veya başka herhangi bir cevap, hiçbir şey düşürmeden ek yapıcı migrate yoluna döner — bilinçli olarak Atla'ya değil; o, hiç kurulmamış bir şema üzerinde seeder'lara devam ederdi.

Mevcut users tablosu uyumsuz olduğunda #

Kit users tablosunu uuid (char(36)) ile anahtarlar ve bir kullanıcıyı işaret eden her kit tablosu buna uygun bir uuid kolonu tanımlar. Kit kurulmadan önce stock bir Laravel uygulamasında php artisan migrate çalıştırmak, users tablosunu bigIncrements id ile yaratır — üstelik stock Laravel'in users migration'ını, kit'in yayınladığı dosya adının aynısıyla (0001_01_01_000000_create_users_table.php) deftere kaydeder. Bu yüzden kit'in kendi uuid sürümü hiç çalışmaz ve users'a giren ilk foreign key çıplak bir SQLSTATE[HY000] ... 3780 ile ölür.

Installer artık strateji sormadan önce bunu yokluyor. Uyumsuz bir users tablosu bulduğunda sebebi ve çözümü yazar, ek yapıcı seçeneği WILL FAIL diye işaretler ve — yine de o seçilirse ya da oturum prompt açamıyorsa — foreign key'in raporlamasını beklemeden migration adımını gerekçesiyle durdurur. Yukarıdaki satır yoklamasının aksine bu yoklama fail-open'dır: okunamayan bir şema uyumsuzluk sayılmaz, yani cevaplayamadığı bir soru yüzünden bir kurulumu asla bloklamaz.

Bunu yalnızca tam bir sıfırlama çözer: bağlantı üzerinde php artisan migrate:fresh, sunulduğunda fresh seçeneği ya da boş bir veritabanı. Ardından php artisan sk:install --resume ile devam edin.

Varsayılan domain eject'i (User + Role) #

Sıfır bir kurulumda installer, User ve Role domain runtime sınıflarını otomatik olarak app/Domain/User/ ve app/Domain/Role/ altına eject eder. Bu iki domain gerçek projelerde en çok özelleştirilen alanlardır; bu nedenle kurulumdan itibaren doğrudan uygulamanıza aittir.

Bu ne anlama gelir:

• Backend sınıfları (Actions, DTOs, Queries, Events, Listeners) App\Domain\ namespace'iyle app/Domain/{User,Role}/ altına kopyalanır.
• DomainServiceProvider, audit log kesintisiz çalışsın diye ilgili Event::listen binding'lerini alır.
• Bu noktadan itibaren kit bu domain'lere composer update aracılığıyla runtime güncellemesi göndermez — dosyalar sizin sorumluluğunuza geçer. Bu, manuel sk:eject çağrısıyla birebir aynı takastır.

Geri alma veya devre dışı bırakma:

Kurulum sonrası eject'i geri almak için app/Domain/User/ ve app/Domain/Role/ dizinlerini silin, app/Providers/DomainServiceProvider.php içindeki enjekte edilen Event::listen satırlarını kaldırın ve composer dump-autoload çalıştırın. Vendor runtime ve alias çözümü otomatik devreye girer.

Sıfır bir kurulumda eject adımını tamamen atlamak için --without-eject kullanın:

php artisan sk:install --without-eject

Domain'ler vendor'da kalır ve class_alias aracılığıyla çözülür; eject öncesi davranışla birebir aynıdır. İstediğiniz zaman sk:eject User / sk:eject Role komutlarını manuel olarak çalıştırabilirsiniz.

Yararlı Flag'ler #

php artisan sk:install --force
php artisan sk:install --adopt
php artisan sk:install --adopt --dry-run
php artisan sk:install --no-interaction
php artisan sk:install --without-ai-skill
php artisan sk:install --without-eject
php artisan sk:install --resume
php artisan sk:install --modules=telescope,pulse

• --force mevcut yayınlanabilir dosyaların üzerine yazar — düzenlediğiniz bir dosya ve kaydın hiç izlemediği bir dosya dâhil — ve "zaten kurulu" güvenlik durdurmasını atlar. --force çalıştırması artık ilk kurulum sayılmaz
• --adopt, kurulu olan ama storage/starter-kit/hashes.json dosyasını kaybetmiş bir uygulama için kurtarma yoludur. Kaydı gönderilen stub'lardan yeniden kurar, başka hiçbir şey yapmaz: dosya kopyalanmaz, migration çalışmaz, .env dosyasına dokunulmaz. Yazacağı kaydı önce görmek için --dry-run ile birlikte kullanın
• --dry-run neyin yazılacağını yazdırır ve hiçbir şey yazmadan çıkar
• --no-interaction CI veya script tabanlı kurulumlar için uygundur; tüm varsayılanları otomatik olarak kabul eder; admin parolası, girecek bir operatör olmadığından her zaman taze bir rastgele değerdir (sonunda ekrana basılır)
• --without-ai-skill Lvntr Starter Kit AI skill'lerinin yayınlanmasını tamamen atlar — hem Claude Code kopyaları (.claude/skills/) hem de Codex aynası (.codex/skills/). Kit'in skill bundle'ını ne Claude Code ne Codex ile kullanan consumer'lar için
• --without-eject varsayılan User ve Role domain eject'ini atlar; runtime vendor'da kalır ve class_alias ile çözülür
• --resume yarıda kalmış bir kurulumu kaldığı yerden devam ettirir: storage/starter-kit/install-progress.json'a checkpoint'lenmiş adımlar atlanır, çalışma başarısız olan adımdan devam eder. Önceden bir checkpoint yoksa uyarıyla birlikte tam bir kurulum çalıştırır.
• --modules= kit ile birlikte kurulacak opsiyonel gözlemlenebilirlik paketlerini seçer (telescope, pulse, horizon, sentry; virgülle ayrılmış ya da tekrarlanan flag ile, örn. --modules=telescope --modules=pulse). Boş bırakılırsa, TTY'de interaktif olarak sorulur; interaktif olmayan bir çalışmada (--no-interaction ya da TTY yok) bu adım atlanır ve hiçbir opsiyonel modül kurulmaz. Aşağıdaki Opsiyonel Gözlemlenebilirlik Recipe'leri bölümüne bakın.

Opsiyonel Gözlemlenebilirlik Recipe'leri #

Kurulum sırasında sk:install, sizin için bir veya daha fazla opsiyonel izleme/hata ayıklama paketini composer require ile ekleyip devreye alabilir:

Telescope bilinçli olarak dev değil, normal bağımlılık olarak kurulur: telescope:install, Telescope'un kendi provider'ından türeyen App\Providers\TelescopeServiceProvider sınıfını bootstrap/providers.php dosyasına kaydeder — composer install --no-dev ile çıkılan bir üretim deploy'unda üst sınıf bulunamaz ve uygulama açılmaz. Telescope'un ürettiği provider zaten local dışında kaydı yalnız exception ve başarısız job'larla sınırlar. Gerçekten yalnız-yerel bir kurulum istiyorsanız, kurulumdan sonra Telescope'un local-only yönergesini elle uygulayın.

Seçim iki şekilde yapılır:

• İnteraktif — --modules= verilmediğinde ve terminal interaktifse, installer "Install optional monitoring/debugging modules?" sorusunu tüm recipe'leri çoklu-seçim olarak sunarak sorar; hiçbirini seçmemek de geçerli bir cevaptır.
• Flag — recipe'leri interaktif olmadan seçmek için (örn. --no-interaction altında da dahil) --modules=telescope,pulse,horizon,sentry verin (ya da flag'i tekrarlayın). Tanınmayan bir anahtar, hiçbir şey yazılmadan önce hızlıca hata ile durur.

Her recipe birbirinden bağımsız ve best-effort olarak denenir: bir recipe için composer require başarısızlığı ya da post-install komutunun başarısız olması kurulumu durdurmaz ya da diğerlerini engellemez. Kurulan ve post-install adımını sorunsuz tamamlayan bir recipe, kurulum özetinde "Optional modules" altında listelenir; kısmen başarısız olan bir recipe ise kalan adımı elle çalıştırmanız gerektiği notuyla başarısızlık listesinde raporlanır.

Bu adım yalnızca paketi ekler ve kendi kurulum komutunu çalıştırır — paketi yapılandırmaz (örn. bir Sentry DSN'i, Telescope'un kendi gate/auth'u, Horizon'un Redis queue bağlantısı ve supervisor süreci). sk:install bittikten sonraki yapılandırma adımı için o paketin kendi dokümantasyonunu izleyin.

4. Frontend Asset'lerini Derleyin #

Kurulum sırasında asset adımını atladıysanız şunları çalıştırın:

npm install
npm run build

Lokal geliştirme için:

composer dev

5. Kurulumu Doğrulayın #

Kurulumdan sonra şu alanları kontrol edin:

• web giriş ekranı (admin@lvntr.dev ve installer'ın bastığı parola, ya da interaktif kurulumda girdiğiniz bilgilerle giriş yapın)
• register ve forgot-password sayfaları; etkinse Turnstile widget'ı
• dashboard erişimi
• kullanıcı ve rol yönetimi sayfaları
• profil güvenliği sayfası (şifre, 2FA, tarayıcı oturumları, avatar)
• ayarlar sayfasındaki sekmeler: General, Auth, Mail, Storage, File Manager, API Integrations, API Clients, API Tokens, System Health
• dosya yöneticisi
• /api/v1/auth/login ve /api/v1/auth/me

6. Kurulum Sonrası Modül Sahipliği #

sk:install yalnızca kurulumdan itibaren özelleştirmeniz beklenen modülleri kopyalar. Mantığı proje özelinde değişme olasılığı düşük olan davranış modülleri, vendor paketinden çalışır — uygulamanıza herhangi bir dosya üretmezler.

Vendor'da çalışan modüller, app.ts vendor-fallback sayfa yükleyicisi tarafından çözülür — uygulamanızda herhangi bir dosya bulunmasına gerek yoktur. Derin özelleştirme için bir vendor-first modülün tam sahipliğini almak üzere sk:eject çalıştırın:

php artisan sk:eject Logs             # controller + FormRequests + Vue sayfalarını uygulamanıza kopyalar
php artisan sk:eject Logs --dry-run   # önce önizleyin
php artisan sk:eject Logs --no-vue    # yalnızca backend
php artisan sk:eject Files            # yalnızca Vue sayfaları (Files backend her zaman vendor'da kalır)

Eject sonrası modülün dosyaları uygulamanızda bulunur ve sk:update bunları sizin dosyalarınız olarak işler — upstream güncellemeler artık otomatik ulaşmaz.

7. İsteğe Bağlı Yayınlama #

Paket birçok varlığı varsayılan olarak kendi içinde tutar. Proje seviyesinde özelleştirme gerektiğinde yayınlayın:

php artisan sk:publish
php artisan sk:publish --tag=components
php artisan sk:publish --tag=composables
php artisan sk:publish --tag=filemanager
php artisan sk:publish --tag=lang
php artisan sk:publish --tag=config

Ek Yapılandırma #

İki config/starter-kit.php anahtarı interaktif installer'ın bir parçası değildir ama kit davranışını değiştirir — kurulumdan önce env üzerinden set edin veya yayınlanmış config dosyasını override edin:

Aynı dosyanın security bloğunun env değişkeni yoktur ve yayınlanmış config üzerinden düzenlenir: enforce_active_status, active_status_denied, active_status_guards (oturum açıkken pasifleştirilen bir hesabın kesilmesi — bkz. Kimlik Doğrulama) ve csp_extra_origins (kitin Content-Security-Policy başlığına eklenen ek origin'ler).

Veritabanını Sıfırlama (site:install) #

Geliştirme sırasında site:install komutu tüm tabloları silip sıfırdan kurar:

php artisan site:install

Bu komut:

1. Onay için hedef veritabanı ve ortam detaylarını gösterir
2. migrate:fresh çalıştırır (tüm tabloları silip migration'ları tekrar çalıştırır)
3. Tüm seeder'ları çalıştırır (database/seeders/ altındaki _ ile başlayan dosyalar)
4. Passport anahtarlarını oluşturur
5. Varsayılan admin kullanıcısını oluşturur

Güvenlik korumaları:

• Sadece local ve setup ortamlarında çalışır
• prod veya production içeren ortamlarda kalıcı olarak engellenir
• Devam etmeden önce açık onay gerektirir

Not: site:install bir stub dosyası olarak yayınlanır. Özelleştirirseniz (örneğin, özel seeder eklerseniz veya admin bilgilerini değiştirirseniz), sk:update komutu değişikliklerinizi tespit eder ve güncelleme sırasında bu dosyayı atlar.

Paketi Güncelleme #

Yeni bir sürüm yayınlandığında:

# 1. Composer paketini güncelleyin
composer update lvntr/laravel-starter-kit

# 2. Uygulama dosyalarını senkronize edin
php artisan sk:update

Güncelleme komutu, paket güncellemelerini özelleştirmelerinizle güvenli şekilde birleştirmek için hash tabanlı izleme sistemi kullanır:

# Hiçbir değişiklik yapmadan nelerin değişeceğini önizleyin
php artisan sk:update --dry-run

# Her şeyi zorla güncelle (özelleştirmelerinizin üzerine yazar)
php artisan sk:update --force

Laravel 12'den Yükseltme #

Mevcut bir Starter Kit projeniz Laravel 12 üzerindeyse:

# 1. composer.json'da Laravel 13 gereksinimini güncelleyin
composer require laravel/framework:^13.0 lvntr/laravel-starter-kit:^13.7 -W

# 2. Yükseltme sihirbazını çalıştırın
php artisan sk:upgrade

Yükseltme komutu Laravel 13+, Starter Kit v13+, PHP 8.4+ doğrular; stub'ları senkronize eder; cache'leri temizler; yeni migration'ları çalıştırır (isteğe bağlı); rolleri ve yetkileri yeniden seed'ler (isteğe bağlı); ve frontend'i yeniden derler.

php artisan sk:upgrade --force       # onay istemlerini atla
php artisan sk:upgrade --skip-build  # npm install / npm run build adımını atla

Tüm Mevcut Komutlar #

Sorun Giderme #

Kurulum sonrası Vite manifest hatası:

npm run build
# veya dev sunucusunu başlatın
npm run dev

Frontend değişiklikleri yansımıyorsa:

npm run dev
# veya yeniden derleyin
npm run build

Kurulum sonrası sınıflar bulunamıyorsa:

composer dump-autoload

Passport anahtarları eksikse:

php artisan passport:keys --force

Deploy sonrası php artisan tinker bulunamıyorsa:

laravel/tinker artık require-dev altında — production build'leri composer install --no-dev ile çalıştığında Tinker kurulmaz. Bu bilinçli bir tercih. Sunucuda tinker'a ihtiyacın varsa composer require laravel/tinker (require-dev dışında) ile açıkça kur.

İlgili dökümanlar:

• update.tr.md
• artisan-commands.tr.md
• ui-components.tr.md