create-kide-app 0.0.36 → 0.1.2

package/templates/base/CLAUDE.md

@@ -1,73 +0,0 @@
-# Kide CMS
-
-Code-first CMS built inside Astro 6.
-
-## Structure
-
-```
-src/cms/cms.config.ts        # Collection definitions (source of truth)
-src/cms/collections/         # Individual collection files
-src/cms/adapters/            # Database, storage, email adapters
-src/cms/internals/           # Runtime, generator, seed scripts
-src/cms/.generated/          # Auto-generated — never edit
-src/components/              # Astro/React components
-src/layouts/                 # Page layouts
-src/pages/                   # Routes
-src/styles/public.css        # Public site styles (plain Tailwind)
-```
-
-## Commands
-
-```bash
-pnpm dev              # start dev server (auto-generates schema + pushes DB)
-pnpm build            # production build
-pnpm cms:generate     # regenerate .generated/ from cms.config.ts
-pnpm cms:seed         # seed database with demo content (if configured)
-```
-
-## Rules
-
-- Never edit files in `src/cms/.generated/` — they are overwritten on every generation.
-- Always query content through the typed local API: `cms.posts.find()`, `cms.pages.findOne()`, etc. Never bypass it with raw DB queries.
-- DB columns use `snake_case`, TypeScript fields use `camelCase`. System fields are prefixed with `_`.
-- Rich text is stored as JSON AST, never HTML or Markdown.
-- `labelField` on collections controls display name in the admin (fallback: title, name, or first text field).
-
-## Stack
-
-Astro 6, React 19, Drizzle ORM, Zod, Tiptap, shadcn/ui, Tailwind CSS v4
-
-## Field Types
-
-Defined in collection files via `fields.*`. All fields share base options: `label`, `description`, `required`, `defaultValue`, `indexed`, `unique`, `translatable`, `condition`, `admin`, `access`.
-
-| Field      | Type-specific options                                                           |
-| ---------- | ------------------------------------------------------------------------------- |
-| `text`     | `maxLength?: number`                                                            |
-| `slug`     | `from?: string` — field to auto-generate slug from                              |
-| `email`    | _(base only)_                                                                   |
-| `number`   | _(base only)_                                                                   |
-| `boolean`  | _(base only)_                                                                   |
-| `date`     | _(base only)_                                                                   |
-| `select`   | `options: string[]` **(required)**                                              |
-| `richText` | _(base only)_ — stored as JSON AST `{ type: "root", children: RichTextNode[] }` |
-| `image`    | _(base only)_ — stores asset reference                                          |
-| `relation` | `collection: string` **(required)**, `hasMany?: boolean`                        |
-| `array`    | `of: FieldConfig` **(required)** — field config for each item                   |
-| `json`     | `schema?: string`                                                               |
-| `blocks`   | `types: Record<string, Record<string, FieldConfig>>` **(required)**             |
-
-`admin` sub-options: `component`, `placeholder`, `position` (`"content"` | `"sidebar"`), `rows`, `help`, `hidden`.
-
-`condition`: `{ field: string; value: string | string[] | boolean }` — show/hide field based on another field's value.
-
-`access`: `{ read?, update? }` — functions receiving `{ user, doc, operation, collection }`, return `boolean`.
-
-## Live Preview
-
-The CMS auto-injects a preview script on every page. To make fields update in real time:
-
-1. Add `?preview` to the page URL.
-2. Add `data-cms="{fieldName}"` attributes to elements that display field values.
-
-For rich text and blocks fields, the preview system uses server-side rendering via `/api/cms/preview/render` (dev only). Simple text fields update via `textContent` directly.

package/templates/base/gitignore

@@ -1,8 +0,0 @@
-node_modules/
-dist/
-.astro/
-data/
-src/cms/.generated/
-public/uploads/
-.cms-cache/
-.env

package/templates/base/package.json

@@ -1,39 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "private": true,
-  "type": "module",
-  "version": "0.0.1",
-  "engines": {
-    "node": ">=22.12.0"
-  },
-  "scripts": {
-    "dev": "astro dev",
-    "build": "astro build",
-    "preview": "astro preview",
-    "check": "astro check",
-    "cms:generate": "node --import tsx src/cms/internals/generator.ts",
-    "cms:admin": "node --import tsx src/cms/internals/create-admin.ts"
-  },
-  "dependencies": {
-    "@kidecms/core": "latest",
-    "@astrojs/node": "^10.0.1",
-    "@astrojs/react": "^5.0.0",
-    "@libsql/client": "^0.15.0",
-    "@tailwindcss/typography": "^0.5.19",
-    "@tailwindcss/vite": "^4.2.1",
-    "astro": "^6.0.4",
-    "drizzle-orm": "^0.45.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "tailwindcss": "^4.2.1",
-    "tw-animate-css": "^1.4.0"
-  },
-  "devDependencies": {
-    "@astrojs/check": "^0.9.7",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "drizzle-kit": "^0.31.9",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
-  }
-}

package/templates/base/src/cms/adapters/db.ts

@@ -1,49 +0,0 @@
-import { mkdirSync } from "node:fs";
-import path from "node:path";
-import Database from "better-sqlite3";
-import { drizzle } from "drizzle-orm/better-sqlite3";
-import { migrate } from "drizzle-orm/better-sqlite3/migrator";
-
-let dbInstance: ReturnType<typeof drizzle> | null = null;
-let sqliteInstance: InstanceType<typeof Database> | null = null;
-let migrated = false;
-
-const getDbPath = () => {
-  const url = process.env.CMS_DATABASE_URL;
-  if (url) return url;
-  return path.join(process.cwd(), "data", "cms.db");
-};
-
-export const getDb = async () => {
-  if (dbInstance) return dbInstance;
-
-  const dbPath = getDbPath();
-  mkdirSync(path.dirname(dbPath), { recursive: true });
-
-  sqliteInstance = new Database(dbPath);
-  sqliteInstance.pragma("journal_mode = WAL");
-  sqliteInstance.pragma("foreign_keys = ON");
-
-  dbInstance = drizzle(sqliteInstance);
-
-  if (!migrated) {
-    const migrationsFolder = path.join(process.cwd(), "src/cms/migrations");
-    try {
-      migrate(dbInstance, { migrationsFolder });
-    } catch {
-      // Ignore migration errors. In dev, tables may already exist via drizzle-kit push.
-    }
-    migrated = true;
-  }
-
-  return dbInstance;
-};
-
-export const closeDb = () => {
-  if (sqliteInstance) {
-    sqliteInstance.close();
-    sqliteInstance = null;
-    dbInstance = null;
-    migrated = false;
-  }
-};

package/templates/base/src/cms/adapters/email.ts

@@ -1,34 +0,0 @@
-export const sendInviteEmail = async (to: string, inviteUrl: string): Promise<boolean> => {
-  const apiKey = import.meta.env.RESEND_API_KEY;
-  if (!apiKey) return false;
-
-  const from = import.meta.env.RESEND_FROM_EMAIL ?? "Kide CMS <noreply@example.com>";
-
-  try {
-    const response = await fetch("https://api.resend.com/emails", {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({
-        from,
-        to,
-        subject: "You've been invited to Kide CMS",
-        html: `
-          <div style="font-family: sans-serif; max-width: 480px; margin: 0 auto;">
-            <h2 style="font-size: 20px;">You've been invited</h2>
-            <p>You've been invited to manage content on Kide CMS. Click the link below to set up your account:</p>
-            <p><a href="${inviteUrl}" style="display: inline-block; padding: 10px 20px; background: #0d9488; color: white; text-decoration: none; border-radius: 6px;">Accept invitation</a></p>
-            <p style="color: #666; font-size: 13px;">This link expires in 7 days. If you didn't expect this invitation, you can safely ignore it.</p>
-          </div>
-        `,
-      }),
-    });
-    return response.ok;
-  } catch {
-    return false;
-  }
-};
-
-export const isEmailConfigured = (): boolean => !!import.meta.env.RESEND_API_KEY;

package/templates/base/src/cms/adapters/storage.ts

@@ -1,38 +0,0 @@
-import { existsSync, mkdirSync } from "node:fs";
-import { readFile, unlink, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-const publicDir = path.join(process.cwd(), "public");
-
-// Resolve storagePath safely under publicDir, rejecting any traversal attempts
-function safeResolve(storagePath: string): string {
-  const resolved = path.resolve(publicDir, storagePath.replace(/^\/+/, ""));
-  if (!resolved.startsWith(publicDir + path.sep) && resolved !== publicDir) {
-    throw new Error(`Invalid storage path: ${storagePath}`);
-  }
-  return resolved;
-}
-
-export async function putFile(storagePath: string, data: ArrayBuffer | Uint8Array): Promise<void> {
-  const filePath = safeResolve(storagePath);
-  const dir = path.dirname(filePath);
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  const buffer = data instanceof Uint8Array ? data : new Uint8Array(data);
-  await writeFile(filePath, buffer);
-}
-
-export async function getFile(storagePath: string): Promise<ArrayBuffer | null> {
-  const filePath = safeResolve(storagePath);
-  if (!existsSync(filePath)) return null;
-  const buffer = await readFile(filePath);
-  return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-}
-
-export async function deleteFile(storagePath: string): Promise<void> {
-  const filePath = safeResolve(storagePath);
-  try {
-    await unlink(filePath);
-  } catch {
-    // File may already be deleted.
-  }
-}

package/templates/base/src/cms/cms.config.ts

@@ -1,7 +0,0 @@
-import { defineConfig } from "@kidecms/core";
-import users from "./collections/users";
-
-export default defineConfig({
-  database: { dialect: "sqlite" },
-  collections: [users],
-});

package/templates/base/src/cms/collections/users.ts

@@ -1,20 +0,0 @@
-import { defineCollection, fields } from "@kidecms/core";
-
-export default defineCollection({
-  slug: "users",
-  labels: { singular: "User", plural: "Users" },
-  auth: true,
-  timestamps: true,
-  views: {
-    list: { columns: ["name", "email", "role", "_updatedAt"] },
-  },
-  fields: {
-    name: fields.text({ required: true }),
-    email: fields.email({ required: true, unique: true }),
-    role: fields.select({
-      options: ["admin", "editor", "viewer"],
-      defaultValue: "editor",
-    }),
-    password: fields.text({ admin: { hidden: true } }),
-  },
-});

package/templates/base/src/cms/internals/create-admin.ts

@@ -1,40 +0,0 @@
-import { createInterface } from "node:readline";
-import { createAdminUser } from "@kidecms/core";
-
-import "./runtime";
-import { closeDb } from "../adapters/db";
-
-const rl = createInterface({ input: process.stdin, output: process.stdout });
-const ask = (question: string): Promise<string> =>
-  new Promise((resolve) => rl.question(question, (answer) => resolve(answer.trim())));
-
-async function main() {
-  const name = await ask("Name: ");
-  if (!name) {
-    console.error("Name is required.");
-    process.exit(1);
-  }
-
-  const email = await ask("Email: ");
-  if (!email) {
-    console.error("Email is required.");
-    process.exit(1);
-  }
-
-  const password = await ask("Password: ");
-  if (!password || password.length < 4) {
-    console.error("Password must be at least 4 characters.");
-    process.exit(1);
-  }
-
-  rl.close();
-
-  await createAdminUser({ name, email, password });
-  console.log(`Admin user "${name}" created.`);
-  closeDb();
-}
-
-main().catch((error) => {
-  console.error(error.message);
-  process.exit(1);
-});

package/templates/base/src/cms/internals/generator.ts

@@ -1,10 +0,0 @@
-import path from "node:path";
-import { generate } from "@kidecms/core";
-
-import config from "../cms.config";
-
-await generate(config, {
-  outputDir: path.join(process.cwd(), "src/cms/.generated"),
-  runtimeImportPath: "../internals/runtime",
-  configImportPath: "../cms.config",
-});

package/templates/base/src/cms/internals/runtime.ts

@@ -1,76 +0,0 @@
-import {
-  configureCmsRuntime,
-  initSchema,
-  createCms,
-  assets,
-  folders,
-  hashPassword,
-  verifyPassword,
-  createSession,
-  validateSession,
-  destroySession,
-  getSessionUser,
-  createInvite,
-  validateInvite,
-  consumeInvite,
-  SESSION_COOKIE_NAME,
-  setSessionCookie,
-  clearSessionCookie,
-  acquireLock,
-  releaseLock,
-  isAiEnabled,
-  getAiModel,
-  streamAltText,
-  streamSeoDescription,
-  streamTranslation,
-} from "@kidecms/core";
-
-import * as schema from "../.generated/schema";
-import { closeDb, getDb } from "../adapters/db";
-import { deleteFile, getFile, putFile } from "../adapters/storage";
-import { isEmailConfigured, sendInviteEmail } from "../adapters/email";
-
-let initialized = false;
-
-export const initCmsRuntime = () => {
-  if (initialized) return;
-
-  initSchema(schema);
-  configureCmsRuntime({
-    getDb,
-    closeDb,
-    storage: { putFile, getFile, deleteFile },
-    email: { sendInviteEmail, isEmailConfigured },
-    env: (key) =>
-      (import.meta as ImportMeta & { env?: Record<string, string | undefined> }).env?.[key] ?? process.env[key],
-  });
-
-  initialized = true;
-};
-
-initCmsRuntime();
-
-export {
-  createCms,
-  assets,
-  folders,
-  hashPassword,
-  verifyPassword,
-  createSession,
-  validateSession,
-  destroySession,
-  getSessionUser,
-  createInvite,
-  validateInvite,
-  consumeInvite,
-  SESSION_COOKIE_NAME,
-  setSessionCookie,
-  clearSessionCookie,
-  acquireLock,
-  releaseLock,
-  isAiEnabled,
-  getAiModel,
-  streamAltText,
-  streamSeoDescription,
-  streamTranslation,
-};

package/templates/base/src/components/BlockRenderer.astro

@@ -1,28 +0,0 @@
----
-const { blocks = [] } = Astro.props as { blocks?: Array<Record<string, unknown>> };
-
-// Discover custom block components from src/components/blocks/
-const customComponents = import.meta.glob<{ default: any }>("./blocks/*.astro", { eager: true });
-
-const componentMap: Record<string, any> = {};
-for (const [path, mod] of Object.entries(customComponents)) {
-  const filename = path.split("/").pop()?.replace(".astro", "") ?? "";
-  const typeName = filename.charAt(0).toLowerCase() + filename.slice(1);
-  componentMap[typeName] = mod.default;
-}
----
-
-<div>
-  {
-    blocks.map((block) => {
-      const type = String(block.type ?? "");
-      const Component = componentMap[type];
-      if (!Component) {
-        throw new Error(
-          `No block component found for type "${type}". Add src/components/blocks/${type.charAt(0).toUpperCase() + type.slice(1)}.astro`,
-        );
-      }
-      return <Component {...block} />;
-    })
-  }
-</div>

package/templates/base/src/env.d.ts

@@ -1,12 +0,0 @@
-/// <reference types="astro/client" />
-
-declare namespace App {
-  interface Locals {
-    user?: {
-      id: string;
-      email: string;
-      name: string;
-      role: string;
-    } | null;
-  }
-}

package/templates/base/src/pages/index.astro

@@ -1,11 +0,0 @@
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width" />
-    <title>My Site</title>
-  </head>
-  <body>
-    <h1>Welcome</h1>
-    <p><a href="/admin">Open Admin</a></p>
-  </body>
-</html>