Kurulum

Yapılandır > Kurulum, adresteki ortam için kurulum kodunu o ortamın token'ı yerleştirilmiş olarak üretir.

Başlamadan önce

• Sayfa, üst satırdaki Development ve Production değiştiricisini izler. Öteki ortam için oradan geçin.
• Development ortamı her adresten yanıt verir. Production yalnızca Domainler sayfasında doğrulanmış bir domainin altındaki sitelerde yanıt verir. DNS kaydının yayılması saatler sürebilir; domaini erken ekleyin.

Kurulum

Üç adım zorunludur:

1. arcy.js'i ekleyin. Önce çatınızı, sonra kullanıcıları nasıl oturum açtırdığınızı seçin. Bu adımdan sonrası, ikisi de seçildiğinde görünür. Sayfa, seçtiğiniz ikiliyi bu yazılım ürünü için tarayıcınızda hatırlar. Kodun kendisi ile init() ve identify() çağrılarının ne yaptığı Hızlı başlangıç sayfasındadır.
2. Yer tutucuları değiştirin. Bu adım yalnızca seçtiğiniz kodda yer tutucu varsa görünür. Her yer tutucunun anlamı Hızlı başlangıç sayfasındadır.
3. Kurulumu doğrulayın. Kontrol, bu ortamın token'ını taşıyan bir oturum bekler. İki dakika sonra Tekrar kontrol et düğmesini bekler.

ARCY MCP ile ajanınıza devredin, ARCY MCP sayfasındaki ARCY'yi uçtan uca kurun maddesini açar. Kodlama ajanınız orada önce arcy.js'i, sonra diğer her yüzeyi kurar.

arcy.js'i güncel tutun

HTML dışındaki her çatıda 1. adım arcy.js'i güncel tutun bloğuyla biter. Blokta güncelleme komutu yer alır, örneğin npm install arcy.js@latest (npm update eski sürüm aralığında kalır). Yanındaki iki dosya her sürüm için bir pull request açar ve kontrolleriniz geçince onu birleştirir. Bloğun dört düğmesi bunların tamamını tek bir görev olarak kopyalar; görevi deponuzda Claude Code, Cursor, Codex veya Antigravity çalıştırır.

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    target-branch: "main"
    schedule:
      interval: "daily"
    cooldown:
      default-days: 2
    allow:
      - dependency-name: "arcy.js"

# Merges Dependabot's arcy.js pull requests once your required checks pass.
name: arcy.js auto-merge

on: pull_request

jobs:
  auto-merge:
    if: github.event.pull_request.user.login == 'dependabot[bot]'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - id: metadata
        # Pinned by digest: a tag can be moved, and this step holds a token
        # that can write to your repository.
        uses: dependabot/fetch-metadata@21025c705c08248db411dc16f3619e6b5f9ea21a # v2.5.0
        with:
          github-token: "${{ secrets.GITHUB_TOKEN }}"
      # A patch only. A minor can carry a change your own code must make,
      # which the Update arcy.js prompt applies; merging it here would skip
      # that step and leave the change unmade.
      - if: steps.metadata.outputs.dependency-names == 'arcy.js' && steps.metadata.outputs.update-type == 'version-update:semver-patch'
        run: gh pr merge --auto --squash "$PR_URL"
        env:
          PR_URL: ${{ github.event.pull_request.html_url }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Varsayılan dalınızın adını target-branch satırına yazın; var olmayan bir dal botu durdurur. Bu satır, allow listesinin güvenlik güncellemelerinizi arcy.js ile sınırlamasını da önler. Deponuzda zaten bir dependabot.yml varsa girdiyi onun updates listesine ekleyin, dosyanın yerine yenisini yazmayın. bun kullanıyorsanız npm yerine bun yazın; Dependabot yalnızca bun.lock dosyasını okur.

İş akışını, varsayılan dalınız bir kontrolü zorunlu kıldıktan sonra ekleyin; yoksa pull request açıldığı anda birleşir. Ardından deponuzun ayarlarında Allow auto-merge seçeneğini açın. Kendi kendine yalnızca yama sürümleri birleşir; bir ara sürüm sizden kendi kodunuzda bir değişiklik isteyebildiği için bekler.

Neyi değiştirir

Doğrulama bir tıklamayı değil, gelen oturumu okur. npm ile yapılan bir kurulumda arcy.js'i güncel tutun bloğu adımların altında açık kalır; her ortamın hangi sürümü çalıştırdığı ve yeni sürümlerin neyi değiştirdiği Güncellemeler sayfasındadır.

Sorun çıktığında

Doğrulama kontrolü sorunu adıyla söyler:

• Bu ortamdan trafik yok: arcy.js yüklensin diye sitenizi başka bir sekmede açın.
• Oturumları başka bir ortam alıyor: canlıdaki kod o ortamın token'ını taşıyor. Sayfayı o ortama geçirin ya da kodunuzdaki token'ı değiştirin.
• Bir siteden gelen istekler reddediliyor: site doğrulanmış bir domainin altında değil. Sitenin domainini Domainler sayfasında doğrulayın.
• Kimlik doğrulama başarısız oluyor: yanlış imzayla gelen oturumlar anonim olarak devam eder. Sunucunuzun ürettiği imzayı Kimlik doğrulama sayfasına göre kontrol edin.
• Bilinmeyen öznitelikler: kontrolün listelediklerini Öznitelikler sayfasında tanımlayın.
• Şimdiye kadar yalnızca localhost trafiği var: kurulum çalışıyor; doğrulanmış bir production domaininden henüz oturum gelmedi.

Ayrıca bakın

• Hızlı başlangıç
• API anahtarları
• Domainler