CLI (corevo)

@corevo-ds/app-cli paketinin komutu corevo'dur. Şablondan üretilen projede devDependencies içinde gelir; npx corevo <komut> veya npm run <script> ile çalışır. Node.js 22+ gerekir.

Proje kökü manifest.json dosyasının bulunduğu klasördür; başka yerden --cwd <klasör> verin.

corevo dev

Yerel dev kabuğu. Varsayılan port 5180.

Bayrak
--port <port>	Kabuk portu
--no-open	Tarayıcıyı açma

App devUrl adresinden (varsayılan http://localhost:5173) sandbox="allow-scripts" iframe'de açılır. Kabuk manifestteki parametrelerden form üretir; dil, görünürlük, çözünürlük, canlı kanal ve olay logu vardır. dev/params.json başlangıç değerleri, dev/files/ medya ve dosyalar, dev/data/<anahtar>.json dataset ve veri kaynağı örnekleridir. Depolama bellek içindedir; mail gönderilmez, loglanır.

Vite'ın CORS ayarı sandbox'ın Origin: null isteğini kabul etmelidir (server.cors: true); şablonda hazırdır.

corevo validate

Manifesti şema ve çapraz kurallarla doğrular. Hata varsa çıkış kodu 1.

Bayrak
--json	{ ok, errors, warnings }
--built	corevo build denetimini zip yazmadan çalıştırır
--against <eski manifest>	Semver uyumu; yeni yetenek isteniyorsa uyarı

corevo build

dist/ altındaki hazır çıktıyı denetler ve .corevo/out/<key>-<version>.zip yazar. Denetimler: Proje yapısı ve build.

corevo login

Panel token'ını kullanıcı config klasörüne kaydeder.

npx corevo login                                   # gizli sorar
echo "$TOKEN" | npx corevo login                   # stdin'den
npx corevo login --panel-url http://127.0.0.1:8000 # başka panel

• Dosya: credentials.json, klasör sırası COREVO_CONFIG_DIR › Windows %APPDATA%\corevo › $XDG_CONFIG_HOME/corevo › ~/.config/corevo.
• Dosya izni 0600, klasör 0700.
• Token panel adresine göre saklanır.
• --token <token> da kabul edilir, ancak kabuk geçmişine düşer; tercih etmeyin.

corevo logout

npx corevo logout                 # varsayılan (veya --panel-url) panelin token'ını siler
npx corevo logout --all           # dosyayı siler

corevo publish

Zip'i panele yükler ve sonucu bekler.

Bayrak
--panel-url <url>	Panel kökü. Varsayılan https://app.corevo.com
--token <token>	Bearer token
--changelog <metin> / --changelog-file <dosya>	Sürüm notu (biri)
--dry-run	İstek atmaz; adres, zip ve not uzunluğunu yazar
--no-wait	Yalnız yükler

Token sırası: --token › COREVO_TOKEN › corevo login ile kaydedilen (aynı panel adresi için). Token hiçbir çıktıda görünmez; hata mesajlarında da *** olur.

Panel adresi sırası: --panel-url › corevo.config.json panelUrl › https://app.corevo.com.

Durum mesajları ve çıkış kodları: Yayınlama ve inceleme.

corevo.config.json

Opsiyonel, proje kökünde:

{
  "devUrl": "http://localhost:5173",
  "outDir": "dist",
  "targets": { "modern": "dist/modern", "legacy": "dist/legacy", "admin": "dist/admin" },
  "panelUrl": "https://app.corevo.com"
}

Boyut sınırları bu dosyadan değiştirilemez. Token bu dosyaya yazılmaz.

Sorun giderme

Hata	Çözüm
SELF_SIGNED_CERT_IN_CHAIN vb.	Yerel HTTPS: NODE_OPTIONS=--use-system-ca veya NODE_EXTRA_CA_CERTS=<CA>
ECONNREFUSED	Bu adreste panel yok; --panel-url'i kontrol edin
Token yok	npx corevo login ya da COREVO_TOKEN
Paket yok. Önce corevo build	npm run build
sdk_version uyuşmuyor	Kurulu @corevo-ds/app-sdk sürümü manifest aralığında değil