Klasör yapısı

Bu sayfa, temanın hangi dosyasında ne olduğunu ve bir işi yapmak için hangi dosyayı açacağınızı gösterir.

Temanın klasörleri

Full sürüm de starter kit de standart bir Laravel 13 uygulamasıdır. Aşağıdaki ağaç full sürümü gösterir; starter kit aynı düzendedir ama örnek sayfaları ve verileri içermez.

full-version/
├── app/
│   ├── Http/Controllers/     Blade sayfalarının denetleyicileri
│   ├── Livewire/             Livewire sayfaları ve bileşenleri
│   └── Support/              Yardımcı sınıflar (JsonDatabase: örnek veriler)
├── config/acun-ui.php        Acun UI ayarları
├── lang/                     Uygulamanın çevirileri (tr.json, en.json)
├── packages/acun-ui/         Acun UI paketleri (aşağıda)
├── public/build/             Derlenmiş CSS ve JavaScript
├── resources/
│   ├── css/acun-ui.css       Tailwind, Acun UI ve @source satırları
│   ├── js/acun-ui.js         Acun UI'nin JavaScript'i
│   ├── js/app.js             Uygulamanın kendi JavaScript'i
│   ├── menu/main.json        Yönetim panelinin menüsü
│   ├── data/                 Örnek veriler (JSON)
│   └── views/                Blade görünümleri (aşağıda)
├── routes/web.php            Yönetim paneli rotaları (/admin)
├── routes/front.php          Önyüz rotaları
├── composer.json             packages/acun-ui klasörünü yerel depo olarak tanır
├── package.json              Derleme araçları (Vite, Tailwind)
└── vite.config.js            Vite girişleri, yazı tipleri, PRO takma adı

Görünümler

resources/views/
├── layouts/
│   ├── admin/
│   │   ├── vertical.blade.php     Kenar menülü panel düzeni
│   │   ├── horizontal.blade.php   Üst menülü panel düzeni
│   │   ├── blank.blade.php        Panelsiz sayfa: giriş, kayıt, hata
│   │   └── sections/              navbar, sidebar, footer: üst çubuk, menü, sayfa altı
│   └── front/
│       ├── theme-1.blade.php …    Önyüzün üç teması (theme-1, theme-2, theme-3)
│       └── sections/              navbar/ ve footer/ altında classic, modern, default
├── admin/                         Yönetim paneli sayfaları
├── front/                         Önyüz sayfaları: home, products, categories, cart, checkout
├── livewire/                      Livewire bileşenlerinin görünümleri
├── components/                    Uygulamanın kendi Blade bileşenleri (logo, giriş ekranı…)
└── partials/                      Küçük parçalar (favicon)

Bir panel sayfası resources/views/admin/ altına yazılır ve düzeni @extends('layouts.admin.vertical') ile kullanır. Livewire sayfaları aynı düzeni #[Layout('layouts.admin.vertical')] ile kullanır. Ayrıntılar: İlk sayfanız.

Hangi dosyayı açmalı?

Acun UI paketleri

Acun UI üç paketten oluşur ve packages/acun-ui/ klasöründe gelir. composer install ve npm install bu klasörleri vendor/acunsoft/ ve node_modules/@acunsoft/ altına bağlar. Paketlerin dosyalarını değiştirmezsiniz; güncelleme klasörü olduğu gibi değiştirir. Bir bileşenin prop'larını ya da kaynağını görmek istediğinizde buraya bakarsınız.

Görünüm ve davranış @acunsoft/acun-ui-core'dan, bileşenlerin işaretlemesi ve sunucu tarafı acunsoft/acun-ui-free'den gelir. PRO sınıfları ücretsiz paketle aynı Acun\Ui\… ad alanındadır; kodunuzda sınıfın hangi paketten geldiğini ayırt etmeniz gerekmez.

@acunsoft/acun-ui-core (acun-ui-core/)

Tema katmanı (CSS) ve temel JavaScript. Laravel'e bağlı değildir.

node_modules/@acunsoft/acun-ui-core/
├── css/panel.css        Tema (@theme), düzen ve menü: @import '@acunsoft/acun-ui-core'
├── js/index.js          Giriş noktası: import '@acunsoft/acun-ui-core'; window.AcunUI'yi kurar
├── js/core/             Çalışma zamanı, olay adları, ayarların okunması, ağır bileşenlerin yüklenmesi, Livewire bağlantısı
├── js/behavior/         Kaydırma kilidi, odak tutma ve geri verme, katman yöneticisi, Livewire düzeltmeleri
├── js/components/       acun:drawer ve acun:modal'ın Alpine bileşenleri (acunDrawer, acunModal)
├── js/appearance/       Tema, ana renk ve menü; Alpine store'ları (sidebar, navbar, customizer, brand, appearance)
├── js/boot.js           Tema dosyası: görünümü ilk çizimden önce uygular
└── vite/index.js        vite.config.js yardımcıları (woff2Only)

acunsoft/acun-ui-free (acun-ui-free/)

Ücretsiz Blade bileşenleri (acun:*) ve onların sunucu tarafı.

vendor/acunsoft/acun-ui-free/
├── config/acun-ui.php                   Düzen, dil, JavaScript adresleri ve PRO için DataTable varsayılanları (yayınlanabilir)
├── dist/acun-ui-boot.js, acun-ui.js     Tema dosyası ve Vite'sız ortak JavaScript (@acunUiScripts)
├── lang/tr.json                         Paketin Türkçe çevirileri
├── resources/icons/heroicons.php        acun:icon'un ikon seti
├── resources/views/components/ui/       acun:* bileşenleri (layout/, nav/ alt klasörleriyle)
├── routes/assets.php, locale.php        dist/ dosyalarının adresi (/acun-ui/{dosya}) ve dil seçimi
└── src/
    ├── Http/                            AssetController (dist/ dosyalarını bir yıllık önbellekle sunar), LocaleController, SetLocale
    ├── Livewire/Concerns/WithToasts.php $this->toast() kısayolları
    ├── Menu/Menu.php                    JSON menü okuyucusu (acun:menu)
    └── Support/                         Assets (@acunUiScripts), Fonts (@acunFonts), Layout (Layout::page), Toast (Toast::flash), Icon

acunsoft/acun-ui-pro (acun-ui-pro/, PRO)

PRO bileşenleri, DataTable, form penceresi ve arama; kendi CSS ve JavaScript'iyle.

vendor/acunsoft/acun-ui-pro/
├── dist/acun-ui-pro.js                  Vite'sız PRO JavaScript'i (@acunUiScripts)
├── lang/tr.json                         Paketin Türkçe çevirileri
├── resources/css/acun-ui-pro.css        DataTable ve form penceresi stilleri
├── resources/js/index.js                Giriş noktası: import '@acunsoft/acun-ui-pro' (Vite takma adı)
├── resources/js/panel/                  Form koruması, grafik, harita, tarih aralığı, lazyLibrary
├── resources/js/ui/                     Ağır bileşenler: combobox, dosya yükleme, DataTable, kaydedilmemiş değişiklik yöneticisi
├── resources/js/form-modal.js           Form penceresi yöneticisi (initDirtyForms)
├── resources/views/components/ui/       PRO acun:* bileşenleri (aynı adlarla)
├── resources/views/components/data-table/  DataTable görünümleri
├── routes/assets.php, datatable.php     acun-ui-pro.js'nin adresi; DataTable indirme ve yazdırma rotaları
└── src/
    ├── DataTable/                       DataTable, Column, Filter, Action, BulkAction, dışa aktarma…
    ├── Form/                            InteractsWithFormModal, FormMode, FormActionState
    ├── Livewire/Concerns/WithListing.php
    ├── Search/                          Arama: Normalizer, SearchField, sürücüler, searchColumn() migration makrosu
    └── Support/ComboboxOptions.php

Daha fazlası

• Hızlı başlangıç: temayı çalıştırmak.
• CSS, JavaScript ve derleme: resources/css ve resources/js dosyalarının ayrıntısı.
• Yapılandırma: config/acun-ui.php ayarları.