launchframe 0.2.0 → 0.2.2

package/template/scripts/sync-agent-rules.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+#
+# sync-agent-rules.sh — Generate AI agent config files from AGENTS.md
+#
+# AGENTS.md is the single source of truth. This script creates copies
+# for agents that don't read AGENTS.md natively (Cline, Continue,
+# Amazon Q, GitHub Copilot Chat).
+#
+# Usage:
+#   bash scripts/sync-agent-rules.sh
+#
+# Agents that DON'T need generated files (they read AGENTS.md natively):
+#   Codex CLI, OpenCode, Cursor, Windsurf, Copilot Coding Agent,
+#   Roo Code, Aider, Augment Code
+#
+# Agents with their own thin pointer files (created manually):
+#   Claude Code  → CLAUDE.md (@AGENTS.md import)
+#   Gemini CLI   → GEMINI.md (@AGENTS.md import)
+#   Cursor       → .cursor/rules/project.mdc (pointer)
+#   Windsurf     → .windsurfrules (pointer)
+#   Aider        → .aider.conf.yml (read: [AGENTS.md])
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+SOURCE="$REPO_ROOT/AGENTS.md"
+
+if [[ ! -f "$SOURCE" ]]; then
+  echo "Error: AGENTS.md not found at $SOURCE" >&2
+  exit 1
+fi
+
+# Resolve @file imports (Claude Code syntax) into inline content.
+# Lines like "@docs/research/INSPECTION_GUIDE.md" become the file's contents.
+resolve_imports() {
+  while IFS= read -r line || [[ -n "$line" ]]; do
+    line="${line%$'\r'}"
+    if [[ "$line" =~ ^@(.+)$ ]]; then
+      local import_path="${BASH_REMATCH[1]}"
+      local resolved="$REPO_ROOT/$import_path"
+      if [[ -f "$resolved" ]]; then
+        cat "$resolved"
+        echo ""
+      else
+        echo "<!-- Import not found: $import_path -->"
+      fi
+    else
+      echo "$line"
+    fi
+  done < "$SOURCE"
+}
+
+RESOLVED_CONTENT="$(resolve_imports)"
+
+HEADER="<!-- AUTO-GENERATED from AGENTS.md — do not edit directly.
+     Run \`bash scripts/sync-agent-rules.sh\` to regenerate. -->"
+
+# Helper: write a generated file with header
+write_file() {
+  local target="$1"
+  local content="$2"
+  mkdir -p "$(dirname "$target")"
+  printf '%s\n\n%s\n' "$HEADER" "$content" > "$target"
+  echo "  ✓ $target"
+}
+
+echo "Syncing agent rules from AGENTS.md..."
+
+# GitHub Copilot Chat — .github/copilot-instructions.md
+write_file "$REPO_ROOT/.github/copilot-instructions.md" "$RESOLVED_CONTENT"
+
+# Cline / Roo Code — .clinerules
+write_file "$REPO_ROOT/.clinerules" "$RESOLVED_CONTENT"
+
+# Continue — .continue/rules/project.md
+CONTINUE_FRONTMATTER="---
+description: Project conventions for AI Website Clone Template
+alwaysApply: true
+---"
+write_file "$REPO_ROOT/.continue/rules/project.md" "$CONTINUE_FRONTMATTER
+$RESOLVED_CONTENT"
+
+# Amazon Q Developer — .amazonq/rules/project.md
+write_file "$REPO_ROOT/.amazonq/rules/project.md" "$RESOLVED_CONTENT"
+
+echo ""
+echo "Done. Generated files are committed to the repo but sourced from AGENTS.md."
+echo "Edit AGENTS.md, then re-run this script to update all agent configs."

package/template/scripts/sync-skills.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+/**
+ * Generates clone-website command/skill files for all supported AI coding platforms.
+ * Source of truth: .claude/skills/clone-website/SKILL.md
+ *
+ * Usage: node scripts/sync-skills.mjs
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
+const SOURCE = join(ROOT, '.claude', 'skills', 'clone-website', 'SKILL.md');
+
+// --- Parse source skill ---
+
+let raw;
+try {
+  raw = readFileSync(SOURCE, 'utf8').replace(/\r\n/g, '\n');
+} catch {
+  console.error(`Error: Source skill not found at .claude/skills/clone-website/SKILL.md`);
+  process.exit(1);
+}
+
+const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+if (!match) {
+  console.error('Error: Could not parse SKILL.md frontmatter');
+  process.exit(1);
+}
+
+const body = match[2];
+const shortDesc = 'Reverse-engineer and clone any website as a pixel-perfect replica';
+
+// --- Helpers ---
+
+function write(relPath, content) {
+  const full = join(ROOT, relPath);
+  mkdirSync(dirname(full), { recursive: true });
+  writeFileSync(full, content, 'utf8');
+  console.log(`  \u2713 ${relPath}`);
+}
+
+const HEADER =
+  '<!-- AUTO-GENERATED from .claude/skills/clone-website/SKILL.md \u2014 do not edit directly.\n' +
+  '     Run `node scripts/sync-skills.mjs` to regenerate. -->\n\n';
+
+const noArgs = (text) => text.replace(/\$ARGUMENTS/g, 'the target URL provided by the user');
+
+// --- Generate ---
+
+console.log('Syncing clone-website skill to all platforms...');
+console.log(`  Source: .claude/skills/clone-website/SKILL.md\n`);
+
+// 1. Codex CLI — same SKILL.md format, same $ARGUMENTS syntax
+write('.codex/skills/clone-website/SKILL.md', raw);
+
+// 2. GitHub Copilot — same SKILL.md format
+write('.github/skills/clone-website/SKILL.md', raw);
+
+// 3. Cursor — plain markdown, no argument substitution support
+write('.cursor/commands/clone-website.md', HEADER + noArgs(body));
+
+// 4. Windsurf — markdown workflow
+write('.windsurf/workflows/clone-website.md', HEADER + noArgs(body));
+
+// 5. Gemini CLI — TOML format, {{args}} for arguments
+const geminiBody = body.replace(/\$ARGUMENTS/g, '{{args}}');
+write(
+  '.gemini/commands/clone-website.toml',
+  `# AUTO-GENERATED from .claude/skills/clone-website/SKILL.md\n` +
+    `# Run \`node scripts/sync-skills.mjs\` to regenerate.\n\n` +
+    `description = "${shortDesc}"\n\n` +
+    `[prompt]\ntext = '''\n${geminiBody}\n'''\n`
+);
+
+// 6. OpenCode — markdown + YAML frontmatter, $ARGUMENTS works natively
+write(
+  '.opencode/commands/clone-website.md',
+  `---\ndescription: "${shortDesc}"\n---\n${HEADER}${body}`
+);
+
+// 7. Augment Code — markdown + YAML frontmatter
+write(
+  '.augment/commands/clone-website.md',
+  `---\ndescription: "${shortDesc}"\nargument-hint: "<url>"\n---\n${HEADER}${body}`
+);
+
+// 8. Continue — prompt file with invokable: true
+write(
+  '.continue/commands/clone-website.md',
+  `---\nname: clone-website\ndescription: "${shortDesc}"\ninvokable: true\n---\n${HEADER}${body}`
+);
+
+// 9. Amazon Q — JSON agent definition
+write(
+  '.amazonq/cli-agents/clone-website.json',
+  JSON.stringify(
+    {
+      name: 'clone-website',
+      description: shortDesc,
+      prompt: noArgs(body),
+      fileContext: ['AGENTS.md', 'docs/research/**'],
+    },
+    null,
+    2
+  ) + '\n'
+);
+
+console.log('\nDone! 9 platform command files generated from source skill.');

package/template/src/app/globals.css

@@ -0,0 +1,130 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+@import "shadcn/tailwind.css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: "Geist", "Geist Fallback", ui-sans-serif, system-ui, sans-serif;
+  --font-mono: "Geist Mono", "Geist Mono Fallback", ui-monospace, monospace;
+  --font-heading: var(--font-sans);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar: var(--sidebar);
+  --color-chart-5: var(--chart-5);
+  --color-chart-4: var(--chart-4);
+  --color-chart-3: var(--chart-3);
+  --color-chart-2: var(--chart-2);
+  --color-chart-1: var(--chart-1);
+  --color-ring: var(--ring);
+  --color-input: var(--input);
+  --color-border: var(--border);
+  --color-destructive: var(--destructive);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-accent: var(--accent);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-muted: var(--muted);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-secondary: var(--secondary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-primary: var(--primary);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-popover: var(--popover);
+  --color-card-foreground: var(--card-foreground);
+  --color-card: var(--card);
+  --radius-sm: calc(var(--radius) * 0.6);
+  --radius-md: calc(var(--radius) * 0.8);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) * 1.4);
+  --radius-2xl: calc(var(--radius) * 1.8);
+  --radius-3xl: calc(var(--radius) * 2.2);
+  --radius-4xl: calc(var(--radius) * 2.6);
+}
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.87 0 0);
+  --chart-2: oklch(0.556 0 0);
+  --chart-3: oklch(0.439 0 0);
+  --chart-4: oklch(0.371 0 0);
+  --chart-5: oklch(0.269 0 0);
+  --radius: 0.625rem;
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --chart-1: oklch(0.87 0 0);
+  --chart-2: oklch(0.556 0 0);
+  --chart-3: oklch(0.439 0 0);
+  --chart-4: oklch(0.371 0 0);
+  --chart-5: oklch(0.269 0 0);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+  html {
+    @apply font-sans;
+  }
+}

package/template/src/app/layout.tsx

@@ -0,0 +1,33 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Website Clone",
+  description: "Pixel-perfect website clone",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html
+      lang="en"
+      className={`${geistSans.variable} ${geistMono.variable} h-full antialiased`}
+    >
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}

package/template/src/app/page.tsx

@@ -0,0 +1,9 @@
+export default function Home() {
+  return (
+    <main className="flex min-h-screen items-center justify-center">
+      <p className="text-muted-foreground">
+        Clone target not yet built. Run <code className="font-mono text-foreground">/clone-website</code> to start.
+      </p>
+    </main>
+  );
+}

package/template/src/components/ui/button.tsx

@@ -0,0 +1,60 @@
+"use client"
+
+import { Button as ButtonPrimitive } from "@base-ui/react/button"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
+        outline:
+          "border-border bg-background hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
+        ghost:
+          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
+        destructive:
+          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default:
+          "h-8 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+        xs: "h-6 gap-1 rounded-[min(var(--radius-md),10px)] px-2 text-xs in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
+        sm: "h-7 gap-1 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
+        lg: "h-9 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-3 has-data-[icon=inline-start]:pl-3",
+        icon: "size-8",
+        "icon-xs":
+          "size-6 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-lg [&_svg:not([class*='size-'])]:size-3",
+        "icon-sm":
+          "size-7 rounded-[min(var(--radius-md),12px)] in-data-[slot=button-group]:rounded-lg",
+        "icon-lg": "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant = "default",
+  size = "default",
+  ...props
+}: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>) {
+  return (
+    <ButtonPrimitive
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }

package/template/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/template/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}