Kurulumu bir ajana yaptırın

Sıkıcı kısmı devredebilirsiniz

Bu depo, bir kodlama aracısının okuyabilmesi için yazılmıştır. Bir harita dosyası (llms.txt), bir kural dosyası (AGENTS.md), dosya başına bellek notları (.ai/) ve görev becerileri (.agents/skills/) içerir. Bağımsız Mobile checkout, prompts/ klasörünü içermez, bu nedenle hazır istem bu kılavuzda yazılıdır — bir dosya açmak yerine aşağıdan kopyalayın.

Yazmayı devretmek, kontrolleri atlamak anlamına gelmez. Ajan, deponun sizdeki kopyası içinde çalışır ve ne yaptığını kanıtıyla bildirmek zorundadır. Aşağıdaki bölümler iyi bir raporun nasıl göründüğünü gösterir, böylece sonucun kontrolü sizde kalır.

Bu yol, Expo uygulamasını ve Web arka ucuna bağlantısını — hesapları ve verileri işleyen sunucuyu — kurar. Checkout'unuz apps/web'i de içeriyorsa, aracı bu arka ucu yerel olarak çalıştırabilir; yalnızca Mobile checkout, size verilen erişilebilir arka uç adresine ihtiyaç duyar.

• Bunun yerine Mobile uygulamasını elle çalıştırın

Önce gerekenler

Önce hazırlık kılavuzunu tamamlayın: Node.js, Git ve bir düzenleyici kurulu olmalı, GitHub daveti kabul edilmeli ve supastack klasörü bilgisayarınıza indirilmiş olmalıdır. Ajan o klasörün içinde çalışır, bu nedenle Başlamadan önce kılavuzundaki her şey hâlâ geçerlidir.

Ayrıca kodlama ajanı olarak işlev görebilen bir araca ihtiyacınız var — yerleşik bir yapay zeka kodlama ajanına sahip bir düzenleyici (bir yapay zeka IDE'si) veya terminalinizde çalışan bir ajan (bir ajan CLI'si). Güncel herhangi bir ajan yetenekli araç iş görür; istem, neyi okuyup neyi çalıştırması gerektiğini zaten açıkça belirtir, bu nedenle talimatları kendiniz yazmanız gerekmez.

Son olarak, istemin istediği iki şeye karar verin: cihazınızın erişebileceği arka uç adresi — yerel arka uç için bilgisayarınızın bir LAN adresi veya verilen HTTPS adresiniz — ve uygulamayı nerede göreceğiniz: bir telefonda Expo Go, bir Mac'te iOS simülatörü veya bir Android emülatörü.

İstemi kopyalayın, iki boşluğu doldurun, yapıştırın

İstem aşağıdaki kod bloğudur — tüm bloğu seçin ve kopyalayın.

İki yer tutucu seçimlerinizi ister. <API_URL>'yi cihazınızın erişebileceği arka uç adresiyle değiştirin — aynı Wi-Fi'daki yerel arka uç için bilgisayarınızın LAN adresi artı 3000 bağlantı noktası, veya verilen HTTPS adresiniz. <DEVICE: expo-go | simulator>'yi fiziksel telefon için expo-go, kurulu bir iOS/Android simülatörü için simulator ile değiştirin. Numaralı adımlar yazıldığı gibi kalır.

Set up this supastack Mobile checkout end to end and open the Expo app on **<DEVICE: expo-go | simulator>** against the backend at **<API_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run corepack pnpm install.
3. Create apps/mobile/.env.local from the names in .env.example: EXPO_PUBLIC_API_URL=<API_URL>, EXPO_PUBLIC_APP_SCHEME=supastack and EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off. Never invent a variable absent from .env.example.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <API_URL> answers from this computer and report its status.
5. Start Expo with corepack pnpm --filter @supastack/mobile start and report the QR preview or simulator launch with the real output.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

Ajan istemle ne yapar

İstem, aracıya haritayı, kuralları ve güvenlik kontrol listesini gösterir, ardından kurulumu sırayla yapmasını ve her aşamayı kanıtlamasını söyler. Basitçe söylemek gerekirse, aracı:

• Hiçbir şeye dokunmadan önce depo haritasını (llms.txt), proje kurallarını (AGENTS.md) ve kimlik bilgisi işleme kurallarını (docs/agent-security.md) okur.
• apps/mobile/.env.local'i yalnızca .env.example'daki adlardan oluşturur — sağladığınız API adresi ve şeması ile — aracı örnek dosyada olmayan bir EXPO_PUBLIC_ ayarını asla uydurmaz.
• Arka ucun adresinizde yanıt verdiğini doğrular — yalnızca bu checkout'ta apps/web klasörü varsa kendisi başlatır — orada olmayan bir sunucuyu varsaymak yerine.
• Bağımlılıkları yükler ve Expo geliştirme sunucusunu başlatır, ardından QR önizlemesini veya simülatör başlatmasını gerçek çıktıyla raporlar.
• Aynı adım iki kez başarısız olduktan sonra durur ve raporlar — bir hatayı atlamaz veya sormadan bir şey silmez.

Ajanın raporunda neyi kontrol edersiniz

İyi bir rapor kanıt gösterir, iddia değil. Her PASS'in arkasında yanıt veren arka uç URL'sini, tamamlanmış bağımlılık kurulumunu ve Expo sunucu çıktısını arayın — 'her şey çalışıyor' gibi bir cümleyi değil.

İstem, aracıya aynı adım iki kez başarısız olduktan sonra durmasını ve raporlamasını — hatayı atlamamasını — ve yıkıcı bir şey yapmadan önce sormasını söyler. Aracınız tekrarlanan başarısızlıklardan sonra doğaçlamaya devam ederse, onu durdurun ve ilk hatayı sorun giderme kılavuzuna götürün.

İki şey asla görünmemelidir: bir hatayı susturmak için kapatılmış bir güvenlik özelliği ve sohbete ya da rapora yazdırılmış parola veya anahtar gibi gizli bir değer. Bunlardan birini görürseniz, çalıştırmayı başarısız sayın.

Önizlemeyi ve gerçek oturum açmayı zihninizde ayrı tutun. Başarılı bir QR önizlemesi yalnızca ekranları gösterir — gerçek hesaplar arka ucun veritabanına ihtiyaç duyar ve gerçek satın almalar bir EAS geliştirme derlemesi gerektirir. 'Önizleme açıldı' henüz 'hesaplar çalışıyor' değildir.

Elle yapmayı tercih ederseniz

Aracının çalıştırdığı her adım aşağıdaki manuel kılavuzlarda yazılıdır — aynı komutlar, aynı kontroller, sizin hızınızda.

• Mobile uygulamasını 5 dakikada çalıştırın
• Tam yerel kurulumu okuyun
• Bir kurulum hatasını düzeltin