blockend-cli 1.0.2

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,399 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/init.ts
+import path, { join as join6 } from "path";
+import fs from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
+import { intro, outro, select, text, confirm, spinner, isCancel } from "@clack/prompts";
+
+// ../detector/dist/index.js
+import { join as join5 } from "path";
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { readFile as readFile2 } from "fs/promises";
+import { existsSync } from "fs";
+import { join as join2 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join3 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { join as join4 } from "path";
+async function readPackageJson(cwd) {
+  const pkgPath = join(cwd, "package.json");
+  try {
+    const content = await readFile(pkgPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    throw new Error(`No package.json found at ${pkgPath}. Run blockend from your project root.`);
+  }
+}
+async function readTsConfig(cwd) {
+  const tsconfigPath = join2(cwd, "tsconfig.json");
+  if (!existsSync(tsconfigPath)) return null;
+  try {
+    const content = await readFile2(tsconfigPath, "utf-8");
+    const cleanLines = content.split(/\r?\n/).filter((line) => {
+      const trimmed = line.trim();
+      return !trimmed.startsWith("//") && !trimmed.startsWith("/*");
+    }).join("\n").replace(/,(\s*[}\]])/g, "$1");
+    return JSON.parse(cleanLines);
+  } catch {
+    return null;
+  }
+}
+async function inferSrcDir(cwd) {
+  const candidates = ["src", "app", "lib"];
+  for (const dir of candidates) {
+    if (existsSync2(join3(cwd, dir))) {
+      return join3(cwd, dir);
+    }
+  }
+  return cwd;
+}
+function detectFramework(deps) {
+  if ("fastify" in deps) return "fastify";
+  if ("hono" in deps) return "hono";
+  if ("express" in deps) return "express";
+  if ("next" in deps) return "next";
+  return "none";
+}
+function detectRuntime(deps) {
+  if ("@types/bun" in deps || "bun-types" in deps) return "bun";
+  return "node";
+}
+function detectPackageManager(cwd) {
+  if (existsSync3(join4(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync3(join4(cwd, "bun.lockb"))) return "bun";
+  if (existsSync3(join4(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+async function detectProject(cwd) {
+  const [pkg, tsConfig] = await Promise.all([readPackageJson(cwd), readTsConfig(cwd)]);
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies,
+    ...pkg.peerDependencies
+  };
+  const srcDir = await inferSrcDir(cwd);
+  return {
+    root: cwd,
+    language: tsConfig !== null ? "typescript" : "javascript",
+    runtime: detectRuntime(allDeps),
+    framework: detectFramework(allDeps),
+    packageManager: detectPackageManager(cwd),
+    hasRedis: "ioredis" in allDeps || "redis" in allDeps,
+    hasPrisma: "@prisma/client" in allDeps,
+    hasDrizzle: "drizzle-orm" in allDeps,
+    aliasMap: tsConfig?.compilerOptions?.paths ? flattenTsPaths(tsConfig.compilerOptions.paths) : {},
+    srcDir,
+    // Default blocks directory: srcDir/lib/blocks
+    blocksDir: join5(srcDir, "lib", "blocks")
+  };
+}
+function flattenTsPaths(paths) {
+  const result = {};
+  for (const [alias, targets] of Object.entries(paths)) {
+    if (targets[0]) {
+      result[alias.replace("/*", "/")] = targets[0].replace("/*", "/");
+    }
+  }
+  return result;
+}
+
+// src/ui/theme.ts
+import pc from "picocolors";
+var theme = {
+  brand: {
+    primary: pc.blue,
+    title: pc.bold,
+    logo: pc.white
+  },
+  text: {
+    normal: pc.white,
+    muted: pc.dim,
+    subtle: pc.gray
+  },
+  state: {
+    success: pc.green,
+    warning: pc.yellow,
+    error: pc.red,
+    info: pc.blue
+  },
+  emphasis: {
+    strong: pc.bold,
+    dim: pc.dim
+  }
+};
+
+// src/ui/format.ts
+var format = {
+  title: (text2) => theme.brand.primary(theme.brand.title(text2)),
+  success: (text2) => theme.state.success(`\u2714 ${text2}`),
+  error: (text2) => theme.state.error(`\u2716 ${text2}`),
+  warning: (text2) => theme.state.warning(text2),
+  muted: (text2) => theme.text.muted(text2),
+  info: (text2) => theme.state.info(text2)
+};
+
+// src/commands/init.ts
+async function initCommand() {
+  const cwd = process.cwd();
+  const configPath = join6(cwd, "blockend.json");
+  console.log(`
+\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557       \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 
+\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551      \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
+\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551      \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
+\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551      \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
+\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D
+\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D
+`);
+  intro(format.title("Blockend \xB7 Intelligent Backend Blocks Setup"));
+  if (existsSync4(configPath)) {
+    const action = await select({
+      message: "blockend.json already exists. What do you want to do?",
+      options: [
+        { value: "keep", label: "Keep existing config (cancel init)" },
+        { value: "overwrite", label: "Overwrite config" },
+        { value: "regenerate", label: "Delete and regenerate" }
+      ]
+    });
+    if (isCancel(action) || action === "keep") {
+      outro(format.muted("Initialization cancelled. Existing config preserved."));
+      return;
+    }
+    if (action === "regenerate") {
+      await fs.unlink(configPath);
+      console.log(format.error("Existing config deleted"));
+    }
+  }
+  const s = spinner();
+  s.start("Scanning project structure...");
+  const context = await detectProject(cwd);
+  s.stop(format.success("Project structure detected"));
+  s.start("Analyzing framework signals...");
+  await new Promise((r) => setTimeout(r, 400));
+  s.stop(format.success(`Detected ${context.framework || "unknown"} environment`));
+  s.start("Resolving alias mappings...");
+  await new Promise((r) => setTimeout(r, 300));
+  s.stop(format.success("Import strategy mapped"));
+  console.log(
+    format.muted(
+      `System: ${context.framework || "unknown"} \xB7 ${context.language || "ts"} \xB7 aliases=${Object.keys(context.aliasMap || {}).length}`
+    )
+  );
+  const framework = await select({
+    message: "Confirm framework environment",
+    initialValue: context.framework || "express",
+    options: [
+      { value: "express", label: "Express.js" },
+      { value: "fastify", label: "Fastify" },
+      { value: "next", label: "Next.js (App Router)" },
+      { value: "hono", label: "Hono" }
+    ]
+  });
+  if (isCancel(framework)) {
+    outro(format.muted("Initialization cancelled."));
+    return;
+  }
+  const language = await select({
+    message: "Confirm primary language",
+    initialValue: context.language === "typescript" ? "typescript" : "javascript",
+    options: [
+      { value: "typescript", label: "TypeScript" },
+      { value: "javascript", label: "JavaScript" }
+    ]
+  });
+  if (isCancel(language)) {
+    outro(format.muted("Initialization cancelled."));
+    return;
+  }
+  const availableAliases = Object.keys(context.aliasMap || {});
+  const baseAliasToken = availableAliases.length > 0 ? availableAliases[0] : "@/";
+  const blockAliasInput = await text({
+    message: "Configure blocks import alias",
+    initialValue: `${baseAliasToken}blocks`,
+    placeholder: `${baseAliasToken}blocks`
+  });
+  if (isCancel(blockAliasInput)) {
+    outro(format.muted("Initialization cancelled."));
+    return;
+  }
+  const blockAlias = String(blockAliasInput);
+  const aliasPrefix = availableAliases.find((a) => blockAlias.startsWith(a)) || "";
+  const physicalPrefix = aliasPrefix ? context.aliasMap[aliasPrefix] : "./";
+  const resolvedSubDir = blockAlias.replace(aliasPrefix, "");
+  const assumedPhysicalDir = join6(physicalPrefix, resolvedSubDir);
+  const relativeBlocksPath = path.relative(cwd, path.resolve(cwd, assumedPhysicalDir));
+  const normalizedPath = relativeBlocksPath.replace(/\\/g, "/");
+  const finalPath = normalizedPath.startsWith(".") ? normalizedPath : `./${normalizedPath}`;
+  let includeRedis = false;
+  if (context.hasRedis) {
+    const redisConfirm = await confirm({
+      message: "Redis detected. Enable Redis-backed block variants automatically?",
+      initialValue: true
+    });
+    if (!isCancel(redisConfirm)) {
+      includeRedis = Boolean(redisConfirm);
+    }
+  }
+  const configPayload = {
+    $schema: "https://blockend.dev/schema.json",
+    environment: framework,
+    language,
+    includeRedis,
+    aliases: {
+      blocks: blockAlias
+    },
+    paths: {
+      blocks: finalPath
+    }
+  };
+  const writeSpinner = spinner();
+  writeSpinner.start("Finalizing configuration...");
+  try {
+    await fs.writeFile(configPath, JSON.stringify(configPayload, null, 2), "utf-8");
+    writeSpinner.stop(format.success("blockend.json ready"));
+    outro(format.title("Blockend initialized successfully. Run: npx blockend add <block>"));
+  } catch {
+    writeSpinner.stop(format.error("Failed to write configuration"));
+  }
+}
+
+// src/commands/add.ts
+import path2, { join as join7 } from "path";
+import fs2 from "fs/promises";
+import { execSync } from "child_process";
+import { intro as intro2, outro as outro2, select as select2, spinner as spinner2, confirm as confirm2 } from "@clack/prompts";
+import pc2 from "picocolors";
+var REPO_OWNER = "codewitnuh";
+var REPO_NAME = "blockend";
+var BRANCH = "master";
+var RAW_CDN_BASE = `https://raw.githubusercontent.com/${REPO_OWNER}/${REPO_NAME}/${BRANCH}`;
+var MANIFEST_URL = `${RAW_CDN_BASE}/registry/index.json`;
+async function addCommand(blockName) {
+  intro2(pc2.bgBlack(pc2.magenta(" Blockend Component Ingestion ")));
+  const cwd = process.cwd();
+  const configPath = join7(cwd, "blockend.json");
+  let config;
+  try {
+    const configFile = await fs2.readFile(configPath, "utf-8");
+    config = JSON.parse(configFile);
+  } catch {
+    outro2(pc2.red("\u2716 blockend.json not found. Run 'npx blockend init' first."));
+    return;
+  }
+  const s = spinner2();
+  s.start("Connecting to remote Blockend Registry manifest...");
+  let registry;
+  try {
+    const response = await fetch(MANIFEST_URL);
+    if (!response.ok) throw new Error(`HTTP Error Status: ${response.status}`);
+    registry = await response.json();
+    s.stop(pc2.green("\u2714 Remote manifest synchronization complete."));
+  } catch {
+    s.stop(pc2.red("\u2716 Failed to fetch the component registry from GitHub network paths."));
+    return;
+  }
+  let targetBlock = blockName;
+  if (!targetBlock) {
+    const availableOptions = Object.keys(registry).map((key) => ({
+      value: key,
+      label: `${key} - pc.dim(${registry[key].description})`
+    }));
+    if (availableOptions.length === 0) {
+      outro2(pc2.yellow("\u26A0 The remote block registry is currently empty."));
+      return;
+    }
+    targetBlock = await select2({
+      message: "Which backend block would you like to inject?",
+      options: availableOptions
+    });
+  }
+  const blockMeta = registry[targetBlock];
+  if (!blockMeta) {
+    outro2(pc2.red(`\u2716 Block "${targetBlock}" does not exist in the remote registry.`));
+    return;
+  }
+  const envKey = String(config.environment);
+  const envConfig = blockMeta.environments[envKey];
+  if (!envConfig) {
+    outro2(
+      pc2.red(
+        `\u2716 The block "${targetBlock}" does not support your environment layout: ${String(config.environment)}`
+      )
+    );
+    return;
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(await fs2.readFile(join7(cwd, "package.json"), "utf-8"));
+  } catch {
+    outro2(pc2.red("\u2716 Could not locate package.json in your current workspace directory."));
+    return;
+  }
+  const installedDeps = {
+    ...packageJson.dependencies ?? {},
+    ...packageJson.devDependencies ?? {}
+  };
+  const missingDeps = envConfig.dependencies.filter((dep) => !(dep in installedDeps));
+  if (missingDeps.length > 0) {
+    console.log(
+      pc2.yellow(`
+\u26A0\uFE0F Missing required infrastructure packages: ${missingDeps.join(", ")}`)
+    );
+    const shouldInstall = await confirm2({
+      message: "Would you like the CLI to automatically install these dependencies?",
+      initialValue: true
+    });
+    if (shouldInstall) {
+      s.start(`Installing dependencies via your native package manager...`);
+      try {
+        const lockfileCheck = await fs2.access(join7(cwd, "pnpm-lock.yaml")).then(() => "pnpm").catch(() => "npm");
+        const installCmd = lockfileCheck === "pnpm" ? `pnpm add ${missingDeps.join(" ")}` : `npm install ${missingDeps.join(" ")}`;
+        execSync(installCmd, { stdio: "ignore", cwd });
+        s.stop(pc2.green("\u2714 Dependencies installed cleanly."));
+      } catch {
+        s.stop(pc2.red("\u2716 Automated dependency installation failed. Please run setup manually."));
+      }
+    }
+  }
+  s.start(`Downloading clean production template block [${targetBlock}]...`);
+  try {
+    const targetFileUrl = `${RAW_CDN_BASE}/${envConfig.path}`;
+    const codeFetchResponse = await fetch(targetFileUrl);
+    if (!codeFetchResponse.ok) {
+      throw new Error(`Failed downloading component source file: ${codeFetchResponse.statusText}`);
+    }
+    const targetCodeTemplate = await codeFetchResponse.text();
+    let physicalPath = config.paths.blocks;
+    if (physicalPath.startsWith("@")) {
+      physicalPath = "./src/blocks";
+    }
+    const targetFolder = path2.resolve(cwd, physicalPath);
+    await fs2.mkdir(targetFolder, { recursive: true });
+    const fileExtension = config.language === "typescript" ? "ts" : "js";
+    const outputFilename = `${targetBlock}.${fileExtension}`;
+    await fs2.writeFile(join7(targetFolder, outputFilename), targetCodeTemplate, "utf-8");
+    const cleanDisplayPath = physicalPath.replace(/\\/g, "/");
+    s.stop(pc2.green(`\u2714 ${outputFilename} successfully injected into codebase.`));
+    outro2(
+      pc2.cyan(
+        `\u2728 Source blocks written to ${cleanDisplayPath}/${outputFilename}. Code ownership transferred!`
+      )
+    );
+  } catch (error) {
+    s.stop(pc2.red("\u2716 Fatal crash occurred while downloading or transferring file layouts."));
+    console.error(error);
+  }
+}
+
+// src/index.ts
+var program = new Command();
+program.name("blockend").description("Zero-dependency production backend blocks CLI").version("0.1.0");
+program.command("init").description("Initialize blockend configuration in your project").action(async () => await initCommand());
+program.command("add [block]").description("Inject unstyled, clean backend blocks directly into code paths").action(async (block) => {
+  await addCommand(block);
+});
+program.parse(process.argv);

package/dist/index.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { intro, outro, select, text } from "@clack/prompts";
+import pc from "picocolors";
+var program = new Command();
+program.name("blockend").description("Zero-dependency production backend blocks CLI").version("0.1.0");
+program.command("init").description("Initialize blockend configuration in your project").action(async () => {
+  intro(pc.bgBlack(pc.cyan(" Blockend Initialization ")));
+  const environment = await select({
+    message: "Select your backend framework environment:",
+    options: [
+      { value: "express", label: "Express.js" },
+      { value: "fastify", label: "Fastify" },
+      { value: "nextjs", label: "Next.js (App Router)" }
+    ]
+  });
+  const blockPath = await text({
+    message: "Where should we save your backend blocks?",
+    initialValue: "./src/blocks",
+    placeholder: "./src/blocks"
+  });
+  console.log("\nWriting configuration target data...");
+  console.log(
+    pc.green(`\u2714 Targets set: Environment -> ${String(environment)}, Path -> ${String(blockPath)}`)
+  );
+  outro(pc.cyan("blockend.json configured mock-successfully."));
+});
+program.command("add [block]").description("Add a backend block to your project").action(async (block) => {
+  intro(pc.bgBlack(pc.magenta(" Blockend Add Tool ")));
+  if (!block) {
+    const selectedBlock = await select({
+      message: "Which backend block would you like to add?",
+      options: [
+        { value: "rate-limiter", label: "rate-limiter (Redis/Memory)" },
+        { value: "auth-handler", label: "auth-handler (JWT/Session)" },
+        { value: "error-handler", label: "global-error-handler" }
+      ]
+    });
+    block = selectedBlock;
+  }
+  console.log(pc.yellow(`
+[Mock Run]: Fetching metadata manifest for "${block}"...`));
+  console.log(pc.green(`\u2714 [Mock Run]: Injected missing dependencies into your package context.`));
+  console.log(pc.green(`\u2714 [Mock Run]: Written file cleanly into your target blocks path.`));
+  outro(pc.magenta(`Successfully added ${block} block!`));
+});
+program.parse(process.argv);

package/dist/templates/auth/index.hbs

@@ -0,0 +1,13 @@
+export interface SessionUser {
+  id: string;
+  email: string;
+  roles: string[];
+}
+
+export function requireRole(user: SessionUser | null, role: string): SessionUser {
+  if (!user || !user.roles.includes(role)) {
+    throw new Error("Unauthorized");
+  }
+
+  return user;
+}

package/dist/templates/auth/meta.json

@@ -0,0 +1,12 @@
+{
+  "name": "auth",
+  "version": "0.1.0",
+  "dependencies": [],
+  "prompts": [],
+  "files": [
+    {
+      "template": "index.hbs",
+      "output": "src/lib/blocks/{{name}}.ts"
+    }
+  ]
+}

package/dist/templates/rate-limiter/index.hbs

@@ -0,0 +1,38 @@
+export interface RateLimitOptions {
+  limit: number;
+  windowMs: number;
+}
+
+export interface RateLimitResult {
+  allowed: boolean;
+  remaining: number;
+  resetAt: number;
+}
+
+const buckets = new Map<string, { count: number; resetAt: number }>();
+
+export function createRateLimiter(options: RateLimitOptions) {
+  return function checkRateLimit(key: string): RateLimitResult {
+    const now = Date.now();
+    const current = buckets.get(key);
+
+    if (!current || current.resetAt <= now) {
+      const resetAt = now + options.windowMs;
+      buckets.set(key, { count: 1, resetAt });
+      return { allowed: true, remaining: options.limit - 1, resetAt };
+    }
+
+    if (current.count >= options.limit) {
+      return { allowed: false, remaining: 0, resetAt: current.resetAt };
+    }
+
+    current.count += 1;
+    return {
+      allowed: true,
+      remaining: Math.max(options.limit - current.count, 0),
+      resetAt: current.resetAt
+    };
+  };
+}
+
+export const rateLimitDriver = "{{driver}}";

package/dist/templates/rate-limiter/meta.json

@@ -0,0 +1,22 @@
+{
+  "name": "rate-limiter",
+  "version": "0.1.0",
+  "dependencies": [],
+  "prompts": [
+    {
+      "id": "driver",
+      "type": "select",
+      "message": "Select your storage backend:",
+      "options": [
+        { "value": "in-memory", "label": "In-Memory (Zero dependencies)" },
+        { "value": "redis", "label": "Redis (Scalable cluster)" }
+      ]
+    }
+  ],
+  "files": [
+    {
+      "template": "index.hbs",
+      "output": "src/lib/blocks/{{name}}.ts"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "blockend-cli",
+  "version": "1.0.2",
+  "description": "Intelligent, modular backend blocks right inside your terminal",
+  "main": "./dist/index.js",
+  "type": "module",
+  "bin": {
+    "blockend": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --out-dir dist"
+  },
+  "keywords": [
+    "cli",
+    "backend",
+    "express",
+    "nextjs",
+    "architecture"
+  ],
+  "author": "codewithnuh",
+  "license": "ISC",
+  "packageManager": "pnpm@10.33.2",
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3"
+  }
+}

package/readme.md

@@ -0,0 +1,30 @@
+# blockend-cli 🚀
+
+Generate reusable backend code blocks directly from your terminal. Instead of rewriting common middleware, utilities, and configuration files, add them to your project with a single command.
+
+## Quick Start
+
+Initialize Blockend in your project:
+
+```bash
+npx blockend-cli init
+```
+
+## Add Code Blocks
+
+Add backend components to your project:
+
+```bash
+npx blockend-cli add
+```
+
+## Features
+
+- **No installation required:** Run it anytime with `npx`.
+- **Works with your project:** Generates code that matches your framework (Express, Next.js, Hono, or Fastify).
+- **Handles dependencies:** Installs required packages when needed.
+- **Your code stays yours:** Writes plain source files directly into your project with no hidden runtime.
+
+## License
+
+ISC