--- 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 ``` CLI, giriş için tarayıcıda partners.ikas.com sayfasını açar. Giriş sırasında Chrome, **Yerel ağ erişimi** veya **Cihazdaki uygulamalar** izni isteyebilir; bu pencerede **İzin ver**'i seçin. İzin reddedilirse giriş tamamlanmaz ve "Bir hata oluştu." ekranı görünür. Çözüm adımları için [CLI giriş sorunları](#cli-login-issues) bölümüne bakın. --- ### 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) - **Dashboard Actions App**: Admin paneline özel aksiyon butonları ekleyen uygulama şablonu - **Starter App with subscription**: Plan satışı ve abonelik yönetimi entegre edilmiş full-stack uygulama şablonu 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? Build a Next.js app (recommended) ✔ Which type of app do you want to build? Starter App (recommended) ✔ App template downloaded ✔ Dependencies installed ✔ Sample app initialized successfully ✔ Do you want to create a new app or use an existing one? Create new app ✔ Select app scopes Read Campaigns, Read Customers, Read Inventories, Read Orders, Read Products, Write Campaigns, Write Customers, Write Inventories, Write Orders, Write Products, Write Storefront ✔ App created ✔ App config saved ✔ .env file updated successfully ✔ Your app is ready! App Name: my-sample-app Client ID: 0b6d3c1e-5a4f-4c2b-9e7d-2f8a1b3c4d5e Client Secret: ********************7f3a App Directory: my-sample-app TODO - Next steps: - `cd my-sample-app` into the app directory - run `ikas app dev` to route traffic to your app - open your favourite IDE and start developing ``` **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ı](https://builders.ikas.com/docs/app-development/admin-app/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 ╭───────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ 💡 You can change the default port and run command in ikas.config.json if needed. │ │ Current Default Port: 3000 - Current Run Command: pnpm run dev │ │ │ ╰───────────────────────────────────────────────────────────────────────────────────────╯ ? Please select the merchant you want to open the app for ❯ ornek-magaza test-magazam ↑↓ navigate • ⏎ select ``` #### 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 ╭───────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ 💡 You can change the default port and run command in ikas.config.json if needed. │ │ Current Default Port: 3000 - Current Run Command: pnpm run dev │ │ │ ╰───────────────────────────────────────────────────────────────────────────────────────╯ ✔ Please select the merchant you want to open the app for ornek-magaza Opening tunnel to port 3000 for default... ✔ Cloudflare tunnel established successfully 🔗 https://sample-words-here.trycloudflare.com -> http://localhost:3000 ✔ App URL routing saved successfully for 8 hours 🌐 Opening the app in the browser... App URL: https://ornek-magaza.myikas.com/admin/app-store/0b6d3c1e-5a4f-4c2b-9e7d-2f8a1b3c4d5e ❗️ If you stop this terminal session, the app routing will be lost and you will need to run `ikas app open` again. ``` Terminal çıktısında göreceğiniz önemli bilgiler: - **Tunnel URL**: Cloudflare'in oluşturduğu public URL ve yönlendirildiği `http://localhost:3000` adresi - **8 saat sınırı**: Uygulama yönlendirmesi 8 saat boyunca geçerli kalır - **App URL**: Uygulamanın seçtiğiniz mağazanın yönetim panelinde açılacağı adres; tarayıcı otomatik olarak açılır - **Uyarı**: Terminal oturumunu kapatırsanız yönlendirme kaybolur. Devam etmek için `ikas app dev` komutunu yeniden çalıştırın (CLI mesajında geçen `ikas app open` adında bir komut yoktur) **Ö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 giriş sorunları [#cli-login-issues] Giriş adımında tarayıcı, partners.ikas.com sayfasından bilgisayarınızda CLI'ın açtığı yerel adrese (`127.0.0.1`) bağlanır. Chrome'un güncel sürümleri bu bağlantı için ayrıca izin ister. İzin daha önce engellendiyse ya da bir güvenlik yazılımı bağlantıyı kesiyorsa partner hesabı seçiminden sonra "Bir hata oluştu." ekranı görünür ve CLI girişi tamamlanmaz. Gizli pencere, site izinlerini normal Chrome profilinden devralır. İzin engelliyse gizli pencerede de aynı hatayı alırsınız. Aşağıdaki adımları sırayla deneyin: 1. **Chrome'da site iznini açın.** partners.ikas.com açıkken adres çubuğunun solundaki simgeye tıklayın ve **Site ayarları**'na girin. **Yerel ağ erişimi** (Local network access) veya **Cihazdaki uygulamalar** iznini **İzin ver** olarak değiştirin. Chrome sürümünüze göre iznin adı bu ikisinden biri olarak görünür. 2. **CLI oturumunu sıfırlayın.** Terminalde önce oturumu kapatın, ardından proje klasöründe geliştirme komutunu yeniden çalıştırın. Oturum kapalı olduğu için CLI sizi tekrar partner girişine yönlendirir. Tarayıcıda izin penceresi açılırsa **İzin ver**'i seçin. ```bash ikas auth logout ikas app dev ``` 3. **VPN, proxy ve güvenlik yazılımlarını kontrol edin.** Sorun devam ederse VPN, proxy veya antivirüs yazılımınızı geçici olarak kapatıp tekrar deneyin. Bu yazılımlar `127.0.0.1` bağlantısını engelleyebilir. 4. **Farklı bir tarayıcı deneyin.** CLI'ın açtığı giriş bağlantısını kopyalayıp Safari veya Firefox'a yapıştırarak girişi tamamlayabilirsiniz. Hata ekranındayken tarayıcının geliştirici araçlarını açın (macOS'ta `Cmd + Option + I`, Windows'ta `F12`) ve **Network** sekmesinin ekran görüntüsünü alın. Destek ekibiyle iletişime geçerken bu görüntüyü paylaşmanız, hatalı isteğin hızlıca bulunmasını sağlar. --- ## 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ı](https://builders.ikas.com/docs/app-development/admin-app/development) - Proje yapısı, tech-stack ve geliştirme workflow'u - [AI ile App Oluşturma](https://builders.ikas.com/docs/app-development/admin-app/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