--- title: ikas CLI description: Proje oluşturma, geliştirme ve publish akışları için komutlar --- ### Gereksinimler * **Node.js:** v16+ gereklidir --- ### Kurulum Bu komut, ikas CLI'ı sisteminize global olarak kurar. Böylece herhangi bir dizinden `ikas` komutlarını çalıştırabilirsiniz. Mevcut komutlar hakkında daha fazla bilgi edinmek için terminalinizde `ikas` komutunu çalıştırmanız yeterlidir. ```bash npm i -g ikas ``` --- ### Komutlar ikas CLI, komutları konulara göre gruplandırır. Komut sözdizimi şöyledir: `ikas [komut]`. En yaygın komutların detayları aşağıda yer almaktadır. Mevcut tüm komutların listesi için kenar çubuğundaki her konu başlığına göz atabilir veya doğrudan terminalinizde `help` komutunu çalıştırabilirsiniz. ```bash ikas help ``` ```console title="Terminal" $ ikas help ikas CLI - ikas application development toolkit USAGE: ikas [command] [options] COMMANDS: app init Create a new ikas application app dev Start development server with tunnel auth login Login to your ikas account auth logout Logout from your ikas account help Show help information --version Show CLI version APP COMMANDS: init Initialize new ikas app project dev Start development server AUTH COMMANDS: login Authenticate with ikas platform logout Clear authentication tokens Use "ikas [command] --help" for more information about a command. ``` #### Komut Referansı | Komut | Kategori | Açıklama | |-------|----------|----------| | `ikas app init` | Uygulama | Yeni ikas uygulaması projesi oluşturur | | `ikas app dev` | Uygulama | Geliştirme sunucusunu başlatır | | `ikas auth login` | Kimlik Doğrulama | ikas hesabınızla CLI'da oturum açar | | `ikas help` | Yardımcı | Mevcut komutların listesini gösterir | | `ikas --version` | Yardımcı | CLI sürümünü gösterir | --- ## Uygulama Komutları ### `ikas app init` Yeni bir ikas uygulaması projesi oluşturur. Bu komut, interaktif bir kurulum süreci başlatır ve geliştirme için hazır bir başlangıç projesi oluşturur. **Kullanım:** ```bash ikas app init ``` **Kurulum Adımları:** 1. **Uygulama Adı**: Projeniz için benzersiz bir ad girin 2. **Framework Seçimi**: Desteklenen framework'lerden birini seçin (Next.js önerilir) 3. **Uygulama Türü**: - **Starter App**: Full-stack uygulama şablonu (önerilen) - **Webhook Listener App**: UI olmadan webhook dinleyici 4. **OAuth Uygulama Oluşturma**: CLI otomatik olarak ikas platformunda OAuth uygulaması oluşturur 5. **Yetki Kapsamları Seçimi**: Uygulamanızın erişebileceği API kapsamlarını seçin 6. **Ortam Değişkenleri**: `.env` dosyası otomatik olarak Client ID ve Secret ile güncellenir **Komut Çıktısı:** ```console title="Terminal" $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. ? What should we call your app? my-sample-app ? For your template, which framework do you want use? (Use arrow keys) ✔ Build a Next.js app (recommended) ? What type of app do you want to build? (Use arrow keys) ✔ Starter app (recommended) ? Do you want to create a new ikas OAuth application? (Use arrow keys) ✔ Create new app ? Select API scopes for your application: ✔ Read Customers, Read Inventories, Read Orders, Read Products 🎉 Congratulations! Your app has been created successfully. 📦 App Details: Name: my-sample-app Client ID: 12345678-1234-1234-1234-123456789012 Client Secret: abcdefghijklmnopqrstuvwxyz123456 ✨ Next steps: 1. cd my-sample-app 2. ikas app dev Happy coding! 🚀 ``` **Oluşturulan Dosyalar:** - Next.js 15 App Router projesi - OAuth 2.0 kimlik doğrulama sistemi - GraphQL API istemcisi - Prisma ORM ile SQLite veritabanı - Tailwind CSS ve shadcn/ui bileşenleri - TypeScript konfigürasyonu - AI geliştirme desteği (.ruler klasörü) - `.env` dosyası (Client ID ve Secret ile otomatik yapılandırılmış) **Sonraki Adımlar:** Komut tamamlandıktan sonra: 1. `cd [uygulama-adı]` ile proje klasörüne geçin 2. `ikas app dev` ile geliştirme sunucusunu başlatın 3. Favori IDE'nizi açıp geliştirmeye başlayın Proje oluşturduktan sonraki geliştirme süreci için [Geliştirme Ortamı](/docs/app-development/admin-app-quick-start/development) sayfasını inceleyin. ### `ikas app dev` Geliştirme sunucusunu başlatır ve trafiği uygulamanıza yönlendirir. Bu komut, uygulamanızı test etmek için gerekli olan Cloudflare tunnel'ını kurar ve mağaza seçimi yapar. **Kullanım:** ```bash ikas app dev ``` **Not:** Bu komut `ikas app init` ile oluşturulmuş proje klasörü içerisinde çalıştırılmalıdır. #### Adım 1: Test Mağazası Seçimi CLI, uygulamanızı test etmek için hangi mağazayı kullanmak istediğinizi sorar. ikas Partners hesabınızda oluşturduğunuz test mağazasını seçin. ```console title="Terminal" $ ikas app dev ? Please select the merchant you want to open the app for (Use arrow keys) ❯ PAEN ``` #### Adım 2: Cloudflare Tunnel Kurulumu CLI otomatik olarak bir Cloudflare tunnel oluşturur ve uygulamanızı internet üzerinden erişilebilir hale getirir. Bu, ikas platform'unun uygulamanıza erişebilmesi için gereklidir. **Terminal Çıktısı:** ```console title="Terminal" $ ikas app dev ✅ Selected merchant: test-magaza 🔗 Setting up Cloudflare tunnel... ✅ Tunnel created successfully! 📡 Tunnel Details: Public URL: https://busy-foxes-12345.trycloudflare.com Local URL: http://localhost:3000 Status: Active (8 hours remaining) 🌐 Opening browser to authorize your application... ⚠️ Keep this terminal open - closing it will stop the tunnel 🚀 Development server is ready! → Visit: http://localhost:3000 → Admin Panel: Opening automatically... ``` Terminal çıktısında göreceğiniz önemli bilgiler: - **Tunnel URL**: Cloudflare tarafından oluşturulan public URL - **Local Mapping**: `http://localhost:3000` bağlantısı - **8 Saat Sınırı**: Tunnel'ın aktif kalacağı süre - **Tarayıcı Açılıyor**: ikas admin paneline otomatik yönlendirme - **Uyarı**: Terminal kapatılırsa tunnel'ın kaybolacağı **Önemli Bilgiler:** - Cloudflare tunnel 8 saat boyunca aktif kalır - Terminal oturumunu kapatırsanız, `ikas app dev` komutunu tekrar çalıştırmanız gerekir - Uygulama otomatik olarak tarayıcıda açılır ve ikas admin paneline yönlendirilir - Yerel geliştirme sunucunuz `http://localhost:3000` adresinde çalışır #### Adım 3: OAuth Yetkilendirme Sayfası Cloudflare tunnel başarıyla kurulduktan sonra, tarayıcınız otomatik olarak `http://localhost:3000/authorize-store` adresine yönlendirilir. Bu sayfada uygulamanızı test etmek istediğiniz mağaza adını girmeniz gerekir. localhost:3000 OAuth yetkilendirme sayfası **Sayfa Detayları:** - **URL**: `http://localhost:3000/authorize-store` - **İşlev**: Mağaza adı girişi ve OAuth yetkilendirme başlatma - **Gerekli Bilgi**: ikas Partners hesabınızda oluşturduğunuz test mağazasının adı - **Sonraki Adım**: "Add to My Store" butonuna tıklayarak OAuth akışını başlatın **Önemli Bilgiler:** - Test mağazanızın tam adını girin (örn: "test-magaza") - Mağaza adı, ikas Partners panelinde oluşturduğunuz test mağazası ile eşleşmelidir - Yanlış mağaza adı girerseniz OAuth yetkilendirme başarısız olur - Doğru mağaza adını girdikten sonra "Add to My Store" butonuna tıklayın #### Adım 4: ikas Admin Panel Bağlantısı OAuth yetkilendirme sayfasından sonra, uygulamanız ikas admin paneline bağlanır ve kimlik doğrulama süreci tamamlanır. ikas admin panelinde uygulama kurulum sayfası ikas admin panel bağlantısı tamamlandı **Başarılı Bağlantı Sonrası:** - "Congratulations! You are authenticated to" mesajını görürsünüz - Uygulamanız artık ikas ekosistemi içinde test edilebilir durumda - Geliştirme için `http://localhost:3000` adresine geri dönebilirsiniz - ikas admin panelinden uygulamanızın fonksiyonlarını test edebilirsiniz Bu noktada uygulamanız: - ikas platform'u ile güvenli OAuth bağlantısı kurmuş - Test mağazasına erişim yetkisi almış - GraphQL API'larını kullanmaya hazır durumda Artık geliştirmeye başlayabilir ve değişikliklerinizi gerçek zamanlı olarak test edebilirsiniz. #### Adım 5: Uygulamayı Test Etme OAuth bağlantısı tamamlandıktan sonra, uygulamanızı ikas admin paneli üzerinden test edebilirsiniz. Aşağıdaki video, test mağazanızda uygulamanızın nasıl çalıştığını gösterir: **Video İçeriği:** - ikas admin panelinde uygulamanızın nasıl göründüğü - Test mağazasında uygulamanın fonksiyonlarının test edilmesi - Localhost geliştirme ortamı ile admin panel arasındaki bağlantının çalışması - Cloudflare tunnel üzerinden gerçek zamanlı veri akışı Bu video adımlarını tamamladıktan sonra: - Uygulamanız ikas ekosisteminde tamamen test edilebilir durumda - Admin panelinden uygulamanızın tüm özelliklerini deneyebilirsiniz - Geliştirme değişiklikleriniz gerçek zamanlı olarak yansıtılır - Production'a hazır bir geliştirme ortamına sahip olursunuz --- ## Kimlik Doğrulama Komutları ### `ikas auth login` ikas hesabınızla CLI'da oturum açar. **Kullanım:** ```bash ikas auth login ``` --- ## Yardımcı Komutlar ### `ikas help` Mevcut tüm komutların listesini ve açıklamalarını gösterir. **Kullanım:** ```bash ikas help ``` ### `ikas --version` Kurulu olan ikas CLI sürümünü gösterir. Güncelleme kontrolü için kullanışlıdır. **Kullanım:** ```bash ikas --version ``` --- ## CLI'ı Yükseltme Mümkünse ikas CLI'ın her zaman en son sürümünü kullanmanızı öneririz. Sürümü yükseltmek için: 1. **Mevcut sürümü kontrol edin:** ```bash ikas --version ``` 2. **En son sürüme yükseltin:** ```bash npm i -g ikas ``` Düzenli olarak `ikas --version` komutunu çalıştırarak güncel sürümde olduğunuzdan emin olun. Yeni özellikler ve hata düzeltmeleri için güncel sürümü kullanmak önemlidir. --- ## Sonraki Adımlar CLI komutlarını kullanarak projenizi oluşturduktan ve geliştirme sunucusunu başlattıktan sonra: **İleri Geliştirme İçin:** - [Geliştirme Ortamı](/docs/app-development/admin-app-quick-start/development) - Proje yapısı, tech-stack ve geliştirme workflow'u - [AI ile App Oluşturma](/docs/app-development/admin-app-quick-start/ai-app-development) - AI agent'lar ile hızlı geliştirme **CLI Komutları ile İlgili:** - Proje içinde `pnpm dev` ile local development server'ı başlatabilirsiniz - `ikas app dev` sadece ikas platform entegrasyonu için gereklidir