@blocofy/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,48 +1,65 @@
 # @blocofy/cli
 
-Blocofy tema geliştirme CLI — Shopify CLI modeli: local tema + **canlı veri** ile anında
-önizleme, sonra yayına alma. CLI **build almaz**; asset'leri kendi araçlarınla
-(npm/Vite/Tailwind) üretirsin, platform Liquid + statik asset olarak sunar.
+Develop your [Blocofy](https://blocofy.com) theme locally against **live data**, see an
+instant preview, and publish. The CLI does **not** build assets — generate them with your
+own tools (npm/Vite/Tailwind); the platform serves plain Liquid + static assets.
 
 ```bash
-npx @blocofy/cli login          # site URL + dev token (admin → Ayarlar → Tema CLI token'ları)
-cd path/to/tema
-npx @blocofy/cli theme dev       # http://localhost:3030 — local tema + canlı veri, livereload
+npx @blocofy/cli login          # site URL + dev token (admin panel: Settings → Theme CLI tokens)
+cd path/to/theme
+npx @blocofy/cli theme dev       # http://localhost:3030 — local theme + live data, livereload
 ```
 
-## Komutlar
+## Commands
 
 ```bash
 blocofy login [--url <url>] [--token <bcf_…>]
-                          # Platform URL + dev token kaydet (~/.blocofy/credentials.json, 0600).
-blocofy theme dev [dir]   # Local dev sunucusu: düzenle → tarayıcı otomatik yenilenir.
-                          # --port <n> (varsayılan 3030)
-blocofy theme pull [dir]  # Canlı temayı diske indir.
-blocofy theme push [dir]  # Local temayı canlı siteye yaz (create/update; silme yok).
+                          # Save your platform URL + dev token (~/.blocofy/credentials.json, 0600).
+blocofy theme dev [dir]   # Local dev server: edit a file and the browser reloads automatically.
+                          # --port <n> (default 3030)
+blocofy theme pull [dir]  # Download the live theme to disk.
+blocofy theme push [dir]  # Write the local theme to the live site (create/update; no delete).
 blocofy --version
 blocofy --help
 ```
 
-## Nasıl çalışır
+## How it works
 
-`theme dev` kendi http sunucusunu açar; her sayfa isteğinde local tema dosyalarını okuyup
-platformun dev-render endpoint'ine (`/api/dev/render`) gönderir. Platform site'ın **canlı
-verisiyle** render edip HTML döner — yani CLI render motorunu içermez, üretimle birebir aynı
-çıktı görürsün. `fs.watch` ile dosya değişince tarayıcı SSE üzerinden yenilenir.
+`theme dev` starts a local HTTP server. For each page request it reads your local theme
+files and sends them to the platform's dev-render endpoint (`/api/dev/render`). The platform
+renders them with the site's **live data** and returns HTML — so the CLI ships no rendering
+engine and you see exactly the production output. A file watcher reloads the browser over
+Server-Sent Events when you save.
 
-Kimlik bilgisi: `~/.blocofy/credentials.json` ya da `BLOCOFY_URL` + `BLOCOFY_TOKEN` ortam
-değişkenleri (CI/agent için).
+Credentials come from `~/.blocofy/credentials.json` (written by `blocofy login`) or the
+`BLOCOFY_URL` + `BLOCOFY_TOKEN` environment variables (for CI/automation).
 
-## Geliştirme
+## Theme structure
 
-Zero-dependency (yalnız Node yerleşikleri). Test:
+A theme is a directory of files grouped by top-level folder:
+
+| Folder | Contents |
+| --- | --- |
+| `layout/` | Page shell (`theme.liquid`) |
+| `section/` | Page sections (`Hero.liquid`, `FeaturedCards.liquid`, …) |
+| `block/` | Repeatable pieces used inside sections |
+| `partial/` | Shared snippets (header/footer, …) |
+| `asset/` | CSS and static files (`theme.css`) |
+| `pages/<slug>.json` | Page content (`/` → `pages/index.json`) |
+| `config/settings.json` | Theme settings + color schemes |
+
+Liquid templates use the `.liquid` extension; files under `asset/` are served as-is.
+
+## Development
+
+Zero runtime dependencies (Node built-ins only). Run the tests with:
 
 ```bash
 node --test
 ```
 
-Node ≥ 18 gerekir.
+Requires Node ≥ 18.
 
-## Lisans
+## License
 
 [MIT](./LICENSE)

package/bin/blocofy.mjs

@@ -1,30 +1,25 @@
 #!/usr/bin/env node
 /**
- * Blocofy tema CLI (#119). Shopify CLI modeli: local tema + canlı veri instant
- * preview, sonra yayına alma.
+ * Blocofy theme CLI. Develop your theme locally against live data with instant
+ * preview, then publish.
  *
- * İki mod:
- *  - Standalone (Faz 3d): `blocofy login` ile platform URL + dev token kaydet →
- *    `blocofy theme dev` kendi http sunucusunu açar, her isteği platformun
- *    `/api/dev/render`'ına proxy'ler (local tema + canlı veri), fs.watch ile
- *    livereload. Monorepo GEREKMEZ → external müşteri `npx @blocofy/cli` ile.
- *  - Monorepo (Faz 2 v1): login yoksa, monorepo içindeyse renderer'ı THEME_DEV_DIR
- *    ile spawn eder (fallback).
+ * `blocofy login` stores your platform URL + dev token, then `blocofy theme dev`
+ * starts a local server that proxies each request to the platform's
+ * `/api/dev/render` endpoint (local theme files + live data) with file-watch
+ * livereload. No monorepo required.
  */
-import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
-import { fileURLToPath } from "node:url";
 
 import { credentialsPath, loadCredentials, saveCredentials } from "../lib/credentials.mjs";
 import { startDevServer } from "../lib/dev-server.mjs";
 import { pullTheme, pushTheme } from "../lib/theme-sync.mjs";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 const args = process.argv.slice(2);
 
-/** `--key value` ve `--flag` (boolean) ayrıştırıcı. */
+/** Parse `--key value` and `--flag` (boolean) arguments. */
 function parseFlags(rest) {
   const flags = {};
   for (let i = 0; i < rest.length; i++) {
@@ -42,36 +37,24 @@ function parseFlags(rest) {
   return flags;
 }
 
-function findMonorepoRoot(start) {
-  let dir = start;
-  for (let i = 0; i < 8; i++) {
-    if (existsSync(resolve(dir, "pnpm-workspace.yaml"))) return dir;
-    const parent = resolve(dir, "..");
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-
 function printHelp() {
-  console.log(`blocofy — Blocofy tema geliştirme CLI (v${VERSION})
+  console.log(`blocofy — Blocofy theme development CLI (v${VERSION})
 
-Kullanım:
+Usage:
   blocofy login [--url <url>] [--token <bcf_…>]
-                            Platform URL + dev token kaydet (~/.blocofy/credentials.json).
-                            Token: admin → Ayarlar → Tema CLI token'ları.
-  blocofy theme dev [dir]   Local tema dev sunucusu — local tema + canlı veri instant
-                            preview. Giriş yapıldıysa standalone (monorepo gerekmez);
-                            yoksa monorepo içinde renderer'ı sarar. dir varsayılan: cwd.
-                            --port <n> (varsayılan 3030), --standalone, --monorepo
-  blocofy theme pull [dir]  Canlı temayı diske indir (giriş gerekli). dir varsayılan: cwd.
-  blocofy theme push [dir]  Local temayı canlı siteye yaz (create/update; v1 silme yok).
+                            Save your platform URL + dev token (~/.blocofy/credentials.json).
+                            Get a token from your admin panel: Settings → Theme CLI tokens.
+  blocofy theme dev [dir]   Local dev server — local theme + live data with instant preview.
+                            Edit a file and the browser reloads automatically. dir defaults to cwd.
+                            --port <n> (default 3030)
+  blocofy theme pull [dir]  Download the live theme to disk. dir defaults to cwd.
+  blocofy theme push [dir]  Write the local theme to the live site (create/update; no delete).
+                            --draft  write to a draft theme instead (preview & publish from the admin panel)
   blocofy --version
   blocofy --help
 
-Yakında (#119): blocofy init, blocofy check.
-Not: CLI build ALMAZ — asset'leri kendi araçlarınla (npm/Vite/Tailwind) üretirsin;
-platform Liquid + statik asset olarak kalır.`);
+The CLI does not build assets — generate them with your own tools (npm/Vite/Tailwind);
+the platform serves plain Liquid + static assets.`);
 }
 
 async function login(rest) {
@@ -82,7 +65,7 @@ async function login(rest) {
   if (!url || !token) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     try {
-      if (!url) url = (await rl.question("Platform/site URL (örn. https://magaza.myblocofy.com): ")).trim();
+      if (!url) url = (await rl.question("Platform/site URL (e.g. https://store.myblocofy.com): ")).trim();
       if (!token) token = (await rl.question("Dev token (bcf_…): ")).trim();
     } finally {
       rl.close();
@@ -91,24 +74,24 @@ async function login(rest) {
 
   url = url.replace(/\/+$/, "");
   if (!/^https?:\/\//.test(url)) {
-    console.error("Geçersiz URL — http(s):// ile başlamalı.");
+    console.error("Invalid URL — must start with http(s)://");
     process.exit(1);
   }
   if (!token.startsWith("bcf_")) {
-    console.error("Geçersiz token — bcf_ ile başlamalı (admin → Ayarlar → Tema CLI token'ları).");
+    console.error("Invalid token — must start with bcf_ (admin panel: Settings → Theme CLI tokens).");
     process.exit(1);
   }
 
   saveCredentials({ url, token });
-  console.log(`Giriş kaydedildi: ${credentialsPath()}`);
-  console.log(`Artık tema dizininde: blocofy theme dev`);
+  console.log(`Saved credentials: ${credentialsPath()}`);
+  console.log(`Now run, in your theme directory: blocofy theme dev`);
 }
 
-/** Giriş bilgisi (URL+token) çöz ya da hata ver. pull/push standalone gerektirir. */
+/** Resolve credentials (URL + token) or exit with guidance. */
 function requireCreds() {
   const creds = loadCredentials();
   if (!creds || !creds.url || !creds.token) {
-    console.error("Giriş gerekli: `blocofy login` (ya da BLOCOFY_URL + BLOCOFY_TOKEN).");
+    console.error("Login required: run `blocofy login` (or set BLOCOFY_URL + BLOCOFY_TOKEN).");
     process.exit(1);
   }
   return creds;
@@ -119,22 +102,29 @@ async function themePull(rest) {
   const dir = resolve(positional[0] ?? process.cwd());
   const creds = requireCreds();
   const { count } = await pullTheme({ dir, url: creds.url, token: creds.token });
-  console.log(`${count} tema dosyası indirildi → ${dir}`);
+  console.log(`Downloaded ${count} theme files → ${dir}`);
 }
 
 async function themePush(rest) {
+  const flags = parseFlags(rest);
   const positional = rest.filter((a) => !a.startsWith("--"));
   const dir = resolve(positional[0] ?? process.cwd());
   if (!existsSync(dir)) {
-    console.error(`Tema dizini yok: ${dir}`);
+    console.error(`Theme directory not found: ${dir}`);
     process.exit(1);
   }
   const creds = requireCreds();
-  const result = await pushTheme({ dir, url: creds.url, token: creds.token });
-  const extra = result.skippedDeletes
-    ? `, ${result.skippedDeletes} uzak dosya yerelde yok (v1: silinmedi)`
-    : "";
-  console.log(`Push: ${result.created} yeni, ${result.updated} güncellendi${extra}.`);
+  const draft = Boolean(flags.draft);
+  const result = await pushTheme({ dir, url: creds.url, token: creds.token, draft });
+  if (result.draft) {
+    console.log(`Pushed to draft theme #${result.instanceId} (${result.created} created, ${result.updated} updated).`);
+    console.log(`Preview & publish it in the admin panel: Theme → Theme library → "Open in editor".`);
+  } else {
+    const extra = result.skippedDeletes
+      ? `, ${result.skippedDeletes} remote file(s) absent locally (not deleted)`
+      : "";
+    console.log(`Push: ${result.created} created, ${result.updated} updated${extra}.`);
+  }
 }
 
 function themeDev(rest) {
@@ -143,83 +133,45 @@ function themeDev(rest) {
   const themeDir = resolve(positional[0] ?? process.cwd());
 
   if (!existsSync(themeDir)) {
-    console.error(`Tema dizini yok: ${themeDir}`);
+    console.error(`Theme directory not found: ${themeDir}`);
     process.exit(1);
   }
 
-  const creds = flags.monorepo ? null : loadCredentials();
-  const canStandalone = Boolean(creds && creds.url && creds.token);
-
-  // Standalone: giriş yapıldıysa (ya da --standalone zorlanırsa).
-  if (canStandalone || flags.standalone) {
-    if (!canStandalone) {
-      console.error("Standalone için giriş gerekli: `blocofy login` (ya da BLOCOFY_URL + BLOCOFY_TOKEN).");
-      process.exit(1);
-    }
-    const port = Number(flags.port) || 3030;
-    console.log(`blocofy theme dev (standalone)`);
-    console.log(`  tema dizini : ${themeDir}`);
-    console.log(`  platform    : ${creds.url}`);
-    console.log(`  token       : ${creds.token.slice(0, 8)}… (${creds.source})`);
-    console.log(`  önizleme    : http://localhost:${port}`);
-    console.log(`  → tema dosyasını düzenle, kaydet = tarayıcı otomatik yenilenir (livereload)`);
-
-    if (flags.dry) {
-      console.log("(--dry: sunucu başlatılmadı)");
-      return;
-    }
-
-    const handle = startDevServer({
-      dir: themeDir,
-      url: creds.url,
-      token: creds.token,
-      port,
-      onError: (err) => {
-        if (err && err.code === "EADDRINUSE") {
-          console.error(`Port ${port} kullanımda. Farklı port: blocofy theme dev --port <n>`);
-        } else {
-          console.error(`Sunucu hatası: ${err?.message ?? err}`);
-        }
-        process.exit(1);
-      },
-    });
-    const shutdown = () => {
-      handle.close();
-      process.exit(0);
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    return;
-  }
-
-  // Monorepo fallback (Faz 2 v1): renderer'ı THEME_DEV_DIR ile spawn et.
-  const root = findMonorepoRoot(dirname(fileURLToPath(import.meta.url)));
-  if (!root) {
-    console.error(
-      "Ne giriş yapıldı ne de monorepo bulundu.\n" +
-        "External kullanım için: `blocofy login` (admin'den dev token al).\n" +
-        "Monorepo içinde çalışıyorsan pnpm-workspace.yaml görünür bir dizinden çalıştır.",
-    );
-    process.exit(1);
-  }
+  const creds = requireCreds();
+  const port = Number(flags.port) || 3030;
 
-  console.log(`blocofy theme dev (monorepo)`);
-  console.log(`  tema dizini : ${themeDir}`);
-  console.log(`  renderer    : ${root} (THEME_DEV_DIR ile)`);
-  console.log(`  önizleme    : http://<slug>.localhost:3003  (örn. test-cafe.localhost)`);
-  console.log(`  → tema dosyasını düzenle, tarayıcıyı yenile = instant preview (gerçek içerikle)`);
+  console.log(`blocofy theme dev`);
+  console.log(`  theme dir : ${themeDir}`);
+  console.log(`  platform  : ${creds.url}`);
+  console.log(`  token     : ${creds.token.slice(0, 8)}… (${creds.source})`);
+  console.log(`  preview   : http://localhost:${port}`);
+  console.log(`  → edit a theme file and save = the browser reloads automatically (livereload)`);
 
   if (flags.dry) {
-    console.log("(--dry: renderer başlatılmadı)");
+    console.log("(--dry: server not started)");
     return;
   }
 
-  const child = spawn("pnpm", ["--filter", "renderer", "dev"], {
-    cwd: root,
-    env: { ...process.env, THEME_DEV_DIR: themeDir },
-    stdio: "inherit",
+  const handle = startDevServer({
+    dir: themeDir,
+    url: creds.url,
+    token: creds.token,
+    port,
+    onError: (err) => {
+      if (err && err.code === "EADDRINUSE") {
+        console.error(`Port ${port} is in use. Try a different port: blocofy theme dev --port <n>`);
+      } else {
+        console.error(`Server error: ${err?.message ?? err}`);
+      }
+      process.exit(1);
+    },
   });
-  child.on("exit", (code) => process.exit(code ?? 0));
+  const shutdown = () => {
+    handle.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
 }
 
 const [first, ...rest] = args;
@@ -246,7 +198,7 @@ if (first === "--version" || first === "-v") {
     process.exit(1);
   });
 } else {
-  console.error(`Bilinmeyen komut: ${args.join(" ")}\n`);
+  console.error(`Unknown command: ${args.join(" ")}\n`);
   printHelp();
   process.exit(1);
 }

package/lib/credentials.mjs

@@ -3,11 +3,11 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 
 /**
- * Blocofy CLI kimlik bilgileri (#119 Faz 3d). `blocofy login` platform URL'i +
- * dev token'ı `~/.blocofy/credentials.json`'a (0600) yazar; `blocofy theme dev`
- * standalone modu bunu okur. Env (BLOCOFY_URL/BLOCOFY_TOKEN) dosyayı geçersiz
- * kılar (CI/agent). Token plaintext diskte tutulur (Shopify/gh CLI deseni) →
- * dosya izni 0600.
+ * Blocofy CLI credentials. `blocofy login` writes the platform URL + dev token to
+ * `~/.blocofy/credentials.json` (0600); `blocofy theme dev` reads it. Environment
+ * variables (BLOCOFY_URL/BLOCOFY_TOKEN) take precedence over the file (CI/agents).
+ * The token is stored in plaintext on disk (the usual dev-CLI pattern), so the file
+ * is locked down to 0600.
  */
 
 const DIR = join(homedir(), ".blocofy");
@@ -17,16 +17,16 @@ export function credentialsPath() {
   return FILE;
 }
 
-/** URL + token'ı 0600 izniyle yaz. */
+/** Write URL + token with 0600 permissions. */
 export function saveCredentials({ url, token }) {
   mkdirSync(DIR, { recursive: true, mode: 0o700 });
   writeFileSync(FILE, JSON.stringify({ url, token }, null, 2) + "\n", { mode: 0o600 });
-  chmodSync(FILE, 0o600); // dosya zaten varsa create-mode uygulanmaz → zorla
+  chmodSync(FILE, 0o600); // create-mode is ignored if the file already exists → enforce it
 }
 
 /**
- * Kimlik bilgisi çöz: önce env (tam çift), sonra dosya. `{ url, token, source }`
- * ya da null. URL sondaki `/`'lardan arındırılır.
+ * Resolve credentials: environment first (both vars), then the file. Returns
+ * `{ url, token, source }` or null. Trailing slashes are stripped from the URL.
  */
 export function loadCredentials() {
   const envUrl = process.env.BLOCOFY_URL;
@@ -40,7 +40,7 @@ export function loadCredentials() {
       return { url: stripSlash(data.url), token: data.token, source: "file" };
     }
   } catch {
-    // dosya yok/bozuk → null
+    // missing/corrupt file → null
   }
   return null;
 }

package/lib/dev-server.mjs

@@ -10,13 +10,13 @@ import {
 } from "./local-theme.mjs";
 
 /**
- * Standalone dev sunucusu (#119 Faz 3d). Her sayfa isteğinde local tema dosyalarını
- * okuyup platformun `/api/dev/render`'ına yollar, dönen HTML'e livereload script'i
- * enjekte eder. `fs.watch` ile dosya değişince SSE üzerinden tarayıcıyı yeniler.
+ * Standalone dev server. For each page request it reads the local theme files and
+ * posts them to the platform's `/api/dev/render` endpoint, then injects a livereload
+ * script into the returned HTML. `fs.watch` reloads the browser over SSE on change.
  *
- * Asset'ler genelde `{% render 'asset/x.css' %}` ile HTML'e GÖMÜLÜ gelir (ayrı
- * istek yok); doğrudan `/asset/*` referansları için diskten statik servis edilir.
- * Görsel/JS uzak (Directus/CDN) → local servise gerek yok.
+ * Assets are usually inlined into the HTML via `{% render 'asset/x.css' %}` (no
+ * separate request); direct `/asset/*` references are served from disk. Images/JS
+ * are remote (Directus/CDN), so no local serving is needed for them.
  */
 export function startDevServer({ dir, url, token, port, onError }) {
   const base = url.replace(/\/+$/, "");
@@ -35,7 +35,7 @@ export function startDevServer({ dir, url, token, port, onError }) {
       try {
         message = JSON.parse(text).error ?? text;
       } catch {
-        /* ham metin */
+        /* raw text */
       }
       return { status: res.status, html: errorHtml(res.status, message) };
     }
@@ -50,7 +50,7 @@ export function startDevServer({ dir, url, token, port, onError }) {
     try {
       const pathname = decodeURIComponent(new URL(req.url, "http://localhost").pathname);
 
-      // Livereload SSE kanalı.
+      // Livereload SSE channel.
       if (pathname === LIVERELOAD_PATH) {
         res.writeHead(200, {
           "content-type": "text/event-stream",
@@ -63,7 +63,7 @@ export function startDevServer({ dir, url, token, port, onError }) {
         return;
       }
 
-      // Doğrudan /asset/* referansı → diskten servis et (varsa).
+      // Direct /asset/* reference → serve from disk (if present).
       const assetFile = safeAssetFile(dir, pathname);
       if (assetFile) {
         res.writeHead(200, { "content-type": contentTypeFor(assetFile), "cache-control": "no-store" });
@@ -71,7 +71,7 @@ export function startDevServer({ dir, url, token, port, onError }) {
         return;
       }
 
-      // Sayfa → platforma render ettir.
+      // Page → render on the platform.
       const { status, html } = await renderPath(pathname);
       res.writeHead(status, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store" });
       res.end(injectLivereload(html));
@@ -95,7 +95,7 @@ export function startDevServer({ dir, url, token, port, onError }) {
       try {
         watcher?.close();
       } catch {
-        /* yoksay */
+        /* ignore */
       }
       for (const client of clients) client.end();
       server.close();
@@ -104,8 +104,9 @@ export function startDevServer({ dir, url, token, port, onError }) {
 }
 
 /**
- * `dir`'i izle; recursive desteklenmiyorsa (eski Node/Linux) recursive'siz dener.
- * Debounce'lu `onChange` çağırır. İzlenemezse null (livereload pasif).
+ * Watch `dir`; if recursive watching is unsupported (older Node/Linux), fall back to
+ * a non-recursive watch. Calls `onChange` debounced. Returns null if unwatchable
+ * (livereload disabled).
  */
 function startWatch(dir, onChange) {
   let timer = null;
@@ -124,7 +125,7 @@ function startWatch(dir, onChange) {
   }
 }
 
-/** `/asset/*` yolunu disk dosyasına eşle (path-traversal korumalı); yoksa null. */
+/** Map a `/asset/*` path to a disk file (path-traversal safe); null if missing. */
 function safeAssetFile(dir, pathname) {
   if (!pathname.startsWith("/asset/")) return null;
   const root = normalize(dir);
@@ -133,7 +134,7 @@ function safeAssetFile(dir, pathname) {
   try {
     if (existsSync(full) && statSync(full).isFile()) return full;
   } catch {
-    /* yoksay */
+    /* ignore */
   }
   return null;
 }
@@ -144,12 +145,12 @@ function escapeHtml(value) {
 
 function errorHtml(status, message) {
   return (
-    `<!doctype html><html lang="tr"><head><meta charset="utf-8">` +
+    `<!doctype html><html lang="en"><head><meta charset="utf-8">` +
     `<title>blocofy dev — ${status}</title></head>` +
     `<body style="font-family:system-ui,sans-serif;padding:2rem;max-width:48rem;margin:0 auto">` +
-    `<h1 style="color:#b91c1c">Render hatası (${status})</h1>` +
+    `<h1 style="color:#b91c1c">Render error (${status})</h1>` +
     `<pre style="white-space:pre-wrap;background:#f4f4f5;padding:1rem;border-radius:.5rem;color:#333">${escapeHtml(message)}</pre>` +
-    `<p style="color:#666">Tema dosyasını düzelt — kaydedince bu sayfa otomatik yenilenir.</p>` +
+    `<p style="color:#666">Fix the theme file — this page reloads automatically when you save.</p>` +
     `</body></html>`
   );
 }

package/lib/local-theme.mjs

@@ -2,25 +2,24 @@ import { readdirSync, readFileSync, statSync } from "node:fs";
 import { extname, join, relative, sep } from "node:path";
 
 /**
- * Local tema dosyalarını okuma + livereload — `@blocofy/cms`'in zero-dep aynası
- * (standalone CLI cms'i bundle edemez). `readLocalTemplates`, cms'teki
- * `loadLocalTemplates` (templates.ts) ile BİREBİR aynı eşlemeyi yapar:
- * üst-dizini THEME_DIRS olan dosyalar, key = göreli yol, `.liquid` strip'li.
+ * Reading local theme files + livereload helpers. `readLocalTemplates` mirrors the
+ * platform's own theme loader exactly: files whose top-level directory is one of
+ * THEME_DIRS, keyed by relative path with the `.liquid` extension stripped.
  */
 
 const THEME_DIRS = new Set(["layout", "section", "block", "partial", "asset", "template"]);
 const LIQUID_KINDS = new Set(["layout", "section", "block", "partial", "template"]);
 
 /**
- * Stripped key → disk yolu (cms `repoPathFor`'un aynası): liquid kind'lara `.liquid`
- * ekler, asset'i ham bırakır. `pull` diske yazarken kullanır (readLocalTemplates tersi).
+ * Stripped key → on-disk path: re-adds `.liquid` for Liquid kinds, leaves assets
+ * raw. Used by `pull` when writing to disk (the inverse of readLocalTemplates).
  */
 export function localPathFor(key) {
   const top = key.split("/")[0] ?? "";
   return LIQUID_KINDS.has(top) && !key.endsWith(".liquid") ? `${key}.liquid` : key;
 }
 
-/** Tema dizinini `{path: content}` haritasına çevir (dev-render'a gönderilir). */
+/** Turn a theme directory into a `{ path: content }` map (sent to dev-render). */
 export function readLocalTemplates(dir) {
   const out = {};
   const walk = (current) => {
@@ -48,7 +47,7 @@ const LIVERELOAD_SNIPPET = `<script>
 
 export { LIVERELOAD_PATH };
 
-/** Render edilen HTML'e livereload script'ini ekle (</body>'den önce). */
+/** Inject the livereload script into rendered HTML (before </body>). */
 export function injectLivereload(html) {
   if (typeof html !== "string") return html;
   return html.includes("</body>")
@@ -76,7 +75,7 @@ const CONTENT_TYPES = {
   ".map": "application/json",
 };
 
-/** Uzantıdan content-type (statik asset servisi için). */
+/** Content-type from a file extension (for static asset serving). */
 export function contentTypeFor(p) {
   return CONTENT_TYPES[extname(p).toLowerCase()] ?? "application/octet-stream";
 }

package/lib/theme-sync.mjs

@@ -4,9 +4,9 @@ import { dirname, join } from "node:path";
 import { localPathFor, readLocalTemplates } from "./local-theme.mjs";
 
 /**
- * `blocofy theme pull/push` (#119 Faz 3e). Platformun `/api/dev/theme` endpoint'iyle
- * konuşur (token Bearer). pull = GET → diske yaz (.liquid re-map); push = readLocalTemplates
- * → POST (create/update; v1 silme yok).
+ * `blocofy theme pull/push`. Talks to the platform's `/api/dev/theme` endpoint
+ * (Bearer token). pull = GET → write to disk (re-adding `.liquid`); push =
+ * readLocalTemplates → POST (create/update; no delete).
  */
 
 async function errorText(res) {
@@ -18,7 +18,7 @@ async function errorText(res) {
   }
 }
 
-/** Canlı temayı diske indir. `{path: content}` (stripped) → `.liquid`'li disk dosyaları. */
+/** Download the live theme to disk. `{ path: content }` (stripped) → `.liquid` files. */
 export async function pullTheme({ dir, url, token }) {
   const base = url.replace(/\/+$/, "");
   const res = await fetch(`${base}/api/dev/theme`, { headers: { authorization: `Bearer ${token}` } });
@@ -34,14 +34,18 @@ export async function pullTheme({ dir, url, token }) {
   return { count };
 }
 
-/** Local temayı canlı siteye yaz (create/update; v1 silme yok). */
-export async function pushTheme({ dir, url, token }) {
+/**
+ * Write the local theme to the site (create/update; no delete). With `draft`,
+ * writes to a draft theme instance instead of the live theme — preview & publish
+ * it from the admin panel without affecting the live site.
+ */
+export async function pushTheme({ dir, url, token, draft = false }) {
   const base = url.replace(/\/+$/, "");
   const files = readLocalTemplates(dir);
   const res = await fetch(`${base}/api/dev/theme`, {
     method: "POST",
     headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
-    body: JSON.stringify({ files }),
+    body: JSON.stringify({ files, draft }),
   });
   if (!res.ok) throw new Error(await errorText(res));
   return res.json();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blocofy/cli",
-  "version": "0.1.0",
-  "description": "Blocofy tema geliştirme CLI — local dev, pull, push (Shopify CLI modeli).",
+  "version": "0.1.2",
+  "description": "Develop your Blocofy theme locally against live data with instant preview — login, theme dev, pull, push.",
   "type": "module",
   "license": "MIT",
   "author": "Blocofy",
@@ -18,7 +18,7 @@
     "theme",
     "cli",
     "liquid",
-    "shopify-cli"
+    "theme-development"
   ],
   "bin": {
     "blocofy": "./bin/blocofy.mjs"