Bağımlılıklar

Bu sayfa temanın ve Acun UI paketlerinin hangi yazılımlara ihtiyaç duyduğunu sürümleriyle listeler.

En kısa örnek

Bilgisayarınızdaki ya da sunucunuzdaki sürümleri denetleyin:

php -v        # 8.3 ya da üstü
composer -V   # 2.2 ya da üstü
node -v       # 20.19 ya da 22.12 ve üstü; yalnızca derlerken gerekir

Üçü de uygunsa tema kurulur ve derlenir. Aşağıdaki sürümler temanın composer.json ve package.json dosyalarından alınmıştır.

PHP tarafı

Paket	Sürüm	Ne için	Zorunlu mu
PHP	8.3 ve üstü	Laravel 13'ü çalıştırır	Evet
Composer	2.2 ve üstü	PHP paketlerini kurar	Evet
`laravel/framework`	`^13.17`	Uygulama çatısı	Evet
`livewire/livewire`	`^4.0`	Etkileşimli bileşenler; Alpine.js'i de getirir	Evet
`acunsoft/acun-ui-core`	zip'teki sürüm	Acun UI'nin CSS'i ve JavaScript'i; ücretsiz paketle birlikte kendiliğinden gelir	Evet
`acunsoft/acun-ui-free`	zip'teki sürüm	Ücretsiz bileşenler	Evet
`acunsoft/acun-ui-pro`	zip'teki sürüm	PRO bileşenler, DataTable, arama	PRO için evet
`laravel/tinker`	`^3.0`	Komut satırında kod denemek	Hayır

Acun UI paketleri tek başına daha geniş bir aralıkta çalışır: PHP 8.2, Laravel 12 ya da 13 ve Livewire 4. Tema bir Laravel 13 uygulaması olduğu için PHP 8.3 ister.

PHP'de Laravel'in istediği eklentiler açık olmalıdır: ctype, filter, hash, mbstring, openssl, session ve tokenizer. Bazı özellikler ek bir eklenti ister:

Eklenti	Ne için	Zorunlu mu
`pdo_sqlite` eklentisi	Full sürümün örnek verisi bellekteki SQLite'ta çalışır	Full sürümde evet
`intl` eklentisi	Sayı ve para biçimini dile göre yazar	Hayır; yoksa paket kendi ayırıcılarını kullanır

Kendi veritabanınız için o veritabanının PDO eklentisi de gerekir (pdo_mysql, pdo_pgsql ya da pdo_sqlite).

Derleme araçları

Bu paketler yalnızca CSS ve JavaScript'i yeniden derlerken gerekir. Derlenmiş dosyalar public/build klasöründe hazır gelir.

Paket	Sürüm	Ne için	Zorunlu mu
Node.js	20.19 ya da 22.12 ve üstü	Derleme araçlarını çalıştırır	Derlerken evet
`vite`	`^8.0.0`	Derleme aracı	Derlerken evet
`laravel-vite-plugin`	`^3.1`	Vite'ı Laravel'e bağlar, yazı tiplerini indirir	Derlerken evet
`tailwindcss`	`^4.0.0`	CSS çatısı	Derlerken evet
`@tailwindcss/vite`	`^4.0.0`	Tailwind'in Vite eklentisi	Derlerken evet
`@tailwindcss/forms`	`^0.5.11`	Form alanlarının temel stili	Derlerken evet
`@acunsoft/acun-ui-core`	`file:packages/acun-ui/acun-ui-core`	Acun UI'nin CSS'i ve JavaScript'i	Derlerken evet
`@laravel/multiplex`	`^0.4.1`	`composer run dev` komutlarını birlikte çalıştırır (macOS, Linux)	Hayır
`concurrently`	`^10.0.3`	Aynı iş Windows'ta; Node.js 22 ister	Hayır

@acunsoft/acun-ui-core npm'den inmez; zip'teki packages/acun-ui/acun-ui-core klasöründen bağlanır.

Tarayıcı kütüphaneleri

Paket	Sürüm	Ne için	Zorunlu mu
Alpine.js	Livewire'ın içindeki sürüm	Bileşenlerin tarayıcıdaki davranışı	Evet; ayrıca kurulmaz
`apexcharts`	`^3.54.1`	Grafikler (`acun:chart`)	Hayır; yalnızca grafikli sayfada yüklenir
`leaflet`	`^1.9.4`	Haritalar (`acun:map`)	Hayır; yalnızca haritalı sayfada yüklenir
`flatpickr`	`^4.6.13`	Tarih aralığı seçici	Hayır; yalnızca kullanan sayfada yüklenir

Alpine.js ve bileşenlerin kullandığı eklentileri (collapse, anchor, sort, mask) Livewire getirir. Alpine'ı ayrıca kurarsanız sayfada iki kopya çalışır.

Grafik, harita ve tarih kütüphaneleri resources/js/app.js içinde kaydedilir. Kullanmadığınız birini kaldırmak için önce app.js içindeki kaydını, sonra package.json satırını silin.

Yazı tipleri ve ikonlar

Ad	Ne için	Zorunlu mu
Public Sans	Panelin metin yazı tipi	Evet (temanın varsayılanı)
DM Mono	Kod ve sayısal etiketler	Evet (temanın varsayılanı)
Plus Jakarta Sans	Önyüz tema 2'nin yazı tipi	Yalnızca tema 2'de
Fraunces	Önyüz tema 3'ün başlıkları	Yalnızca tema 3'te
Heroicons	`acun:icon` ikonları (v2.2.0, 324 ikon)	Pakete dahil; kurulmaz

Yazı tipleri derleme sırasında Bunny Fonts'tan indirilir ve public/build içine konur. Canlı site Bunny Fonts'a bağlanmaz; derlemeyi yapan makinenin internete erişmesi yeterlidir. Hangi yazı tiplerinin derleneceği vite.config.js içindeki fonts listesindedir.

İkonlar ve dil seçicinin bayrakları paketin içinde satır içi SVG olarak gelir; ayrıca dosya indirilmez.

Güncellemek

composer update   # PHP paketleri, composer.json'daki aralıklar içinde
npm update        # derleme araçları ve kütüphaneler, package.json'daki aralıklar içinde
npm run build     # ardından yeniden derleyin

Bu komutlar aralığın dışına çıkmaz; örneğin Tailwind CSS 4'ten 5'e geçmez. Büyük bir sürüme geçmeden önce o paketin yükseltme notlarını okuyun. Acun UI paketleri ise yeni zip ile güncellenir; adımlar Hızlı başlangıç sayfasındadır.

Lisanslar

Üçüncü parti yazılımların lisansları THIRD-PARTY-NOTICES.md dosyasındadır. Projelerin listesi ve adresleri Katkılar sayfasındadır.

Daha fazlası

Hızlı başlangıç: temayı kurmak ve güncellemek.
CSS, JavaScript ve derleme: vite.config.js, yazı tipleri ve kütüphanelerin yüklenmesi.
Yayına alma: sunucuda neyin gerektiği.
Katkılar: kullanılan açık kaynak projeler.