Proje Yapısı
Kod modu projesindeki dosya ve klasörler.
ikas theme init komutuyla oluşturulan proje, Preact tabanlı bir bileşen geliştirme ortamı sunar. Aşağıda projedeki dosya ve klasörlerin görevleri listelenmiştir.
Klasör yapısı
my-theme/
├── .cursor/
│ └── mcp.json # Cursor için ikas MCP yapılandırması
├── .cursorrules # Cursor kuralları
├── .gitignore
├── .mcp.json # Genel MCP yapılandırması
├── CLAUDE.md # Claude için proje rehberi
├── README.md
├── ikas.config.json # Otomatik yönetilen bileşen kayıt yapılandırması
├── package.json
├── package-lock.json
├── tsconfig.json
├── vite.config.ts
└── src/
├── components/
│ ├── <Bileşen>/
│ │ ├── components/ # Bileşene özel alt bileşenler
│ │ │ └── <AltBileşen>/
│ │ │ ├── index.tsx
│ │ │ └── styles.css
│ │ ├── index.tsx # Preact bileşen kodu
│ │ ├── styles.css # Bileşene özel CSS
│ │ └── types.ts # Otomatik üretilir
│ └── index.ts # Otomatik üretilir
├── hooks/ # Tema geneli paylaşılan Preact hook'ları
│ └── useExample.ts
├── sub-components/ # Tema geneli paylaşılan alt bileşenler
│ └── <AltBileşen>/
│ ├── index.tsx
│ └── styles.css
├── utils/ # Tema geneli yardımcı fonksiyonlar
│ └── example.ts
├── global-types.ts # Otomatik üretilir
├── global.css # Tema geneli CSS
└── ikas-component-utils.d.ts # Otomatik üretilirManuel olarak düzenlenebilen dosyalar
Geliştirme yaparken aşağıdaki dosyalarda doğrudan değişiklik yapabilirsiniz:
src/components/<Bileşen>/index.tsx— Bileşenin Preact kodu burada yazılır.src/components/<Bileşen>/styles.css— Bileşene özel stiller.src/components/<Bileşen>/components/— Yalnızca o bileşen içinde kullanılacak alt bileşenler için açılan opsiyonel klasör. Her alt bileşenin kendiindex.tsxvestyles.cssdosyaları olabilir.src/hooks/— Tema genelinde paylaşılan Preact hook'larını barındırır.src/sub-components/— Tema genelinde paylaşılan alt bileşenler. Birden fazla bileşende kullanılan UI parçaları (buton, modal, kart vb.) burada tutulur.src/utils/— Tema genelinde paylaşılan yardımcı fonksiyonlar.src/global.css— Tema genelinde geçerli olan ortak stiller.
Otomatik yönetilen dosyalar
Otomatik yönetilen dosyalar
Aşağıdaki dosyalar sistem ile bağlantılı olarak otomatik üretilir ve kesinlikle düzenlenmemelidir:
ikas.config.jsonsrc/global-types.tssrc/ikas-component-utils.d.tssrc/components/<Bileşen>/types.tssrc/components/index.ts
Bu dosyalarla ilgili güncellemeleri her zaman AI asistanınıza bırakmanız önerilir; manuel müdahale tutarsızlığa ve derleme hatasına yol açabilir.