create-lingcode 0.1.0

package/bin/create-lingcode.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// npm create lingcode@latest [directory] [--template <name>] [--no-install]
+
+import { spawnSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { cp, readFile, rename, writeFile } from 'node:fs/promises';
+import { basename, join, relative, resolve } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+
+const TEMPLATES_DIR = fileURLToPath(new URL('../templates/', import.meta.url));
+const DEFAULT_TEMPLATE = 'react-vite-chat';
+
+export function parseArgs(argv) {
+  const out = { dir: null, template: DEFAULT_TEMPLATE, install: true };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--template' || arg === '-t') out.template = argv[++i];
+    else if (arg.startsWith('--template=')) out.template = arg.slice('--template='.length);
+    else if (arg === '--no-install') out.install = false;
+    else if (!arg.startsWith('-') && !out.dir) out.dir = arg;
+  }
+  return out;
+}
+
+export function packageNameFrom(dir) {
+  const name = basename(resolve(dir)).toLowerCase().replace(/[^a-z0-9-~._]+/g, '-').replace(/^[-._]+|[-._]+$/g, '');
+  return name || 'lingcode-app';
+}
+
+// The package manager that ran `create`, so installs match the user's choice.
+export function packageManager(env = process.env) {
+  const agent = String(env.npm_config_user_agent || '');
+  for (const pm of ['pnpm', 'yarn', 'bun']) if (agent.startsWith(pm)) return pm;
+  return 'npm';
+}
+
+export async function scaffold({ dir, template = DEFAULT_TEMPLATE }) {
+  const source = join(TEMPLATES_DIR, template);
+  if (!existsSync(source)) {
+    const available = readdirSync(TEMPLATES_DIR).join(', ');
+    throw new Error(`Unknown template "${template}". Available: ${available}`);
+  }
+  const target = resolve(dir);
+  if (existsSync(target) && readdirSync(target).length) {
+    throw new Error(`${relative(process.cwd(), target) || target} is not empty.`);
+  }
+  await cp(source, target, { recursive: true });
+  // npm strips .gitignore from published packages, so templates ship _gitignore.
+  if (existsSync(join(target, '_gitignore'))) await rename(join(target, '_gitignore'), join(target, '.gitignore'));
+  const pkgFile = join(target, 'package.json');
+  const pkg = JSON.parse(await readFile(pkgFile, 'utf8'));
+  pkg.name = packageNameFrom(target);
+  await writeFile(pkgFile, `${JSON.stringify(pkg, null, 2)}\n`);
+  return target;
+}
+
+async function main(argv) {
+  const args = parseArgs(argv);
+  if (!args.dir) {
+    if (process.stdin.isTTY) {
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      args.dir = (await rl.question('Project directory (my-lingcode-app): ')).trim() || 'my-lingcode-app';
+      rl.close();
+    } else {
+      args.dir = 'my-lingcode-app';
+    }
+  }
+  const target = await scaffold(args);
+  const shown = relative(process.cwd(), target) || '.';
+  console.log(`Created ${shown} from the ${args.template} template.`);
+
+  const pm = packageManager();
+  if (args.install) {
+    console.log(`Installing dependencies with ${pm}…`);
+    const result = spawnSync(pm, ['install'], { cwd: target, stdio: 'inherit', shell: process.platform === 'win32' });
+    if (result.status !== 0) console.log(`\nInstall failed; run \`${pm} install\` inside ${shown} yourself.`);
+  }
+
+  const run = pm === 'npm' ? 'npm run' : pm;
+  const steps = [
+    [`cd ${shown}`, ''],
+    ...(args.install ? [] : [[`${pm} install`, '']]),
+    ['npx lingcode dev', '# sign in, create your dev backend, deploy lingcode/'],
+    [`${run} dev`, '# in a second terminal: start the app'],
+  ];
+  const width = Math.max(...steps.filter(([, note]) => note).map(([cmd]) => cmd.length)) + 2;
+  console.log(`\nNext steps:\n${steps.map(([cmd, note]) => `  ${note ? cmd.padEnd(width) + note : cmd}`).join('\n')}\n`);
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  main(process.argv.slice(2)).catch((err) => {
+    console.error(`Error: ${err.message}`);
+    process.exitCode = 1;
+  });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "create-lingcode",
+  "version": "0.1.0",
+  "description": "Create a new app on LingCode Cloud: `npm create lingcode@latest`.",
+  "type": "module",
+  "bin": {
+    "create-lingcode": "bin/create-lingcode.mjs"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "keywords": ["lingcode", "create", "template", "backend"],
+  "homepage": "https://lingcode.dev/docs/cloud/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Xavierhuang/LingCode.git",
+    "directory": "packages/create-lingcode"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/react-vite-chat/README.md

@@ -0,0 +1,16 @@
+# LingCode chat
+
+A realtime chat app on LingCode Cloud.
+
+```sh
+npx lingcode dev   # terminal 1: dev backend, .env.local, deploys lingcode/ on save
+npm run dev        # terminal 2: the Vite app
+```
+
+Open the app in two tabs and send a message.
+
+- `lingcode/migrations/` — SQL schema and row-level security. Add a new numbered file for every change.
+- `lingcode/functions/` — server-side TypeScript functions, called with `lingcode.functions.invoke(name, body)`.
+- `lingcode/_generated/` — types generated from your schema.
+
+Ship the backend with `npx lingcode deploy`, which previews the production changes and asks before applying.

package/templates/react-vite-chat/_gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.env.local

package/templates/react-vite-chat/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>LingCode chat</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/templates/react-vite-chat/lingcode/migrations/0001_messages.sql

@@ -0,0 +1,16 @@
+-- Applied migrations are immutable. To change the schema, add 0002_….sql.
+create table messages (
+  id uuid primary key default gen_random_uuid(),
+  author text not null check (char_length(author) between 1 and 40),
+  body text not null check (char_length(body) between 1 and 1000),
+  created_at timestamptz not null default now()
+);
+
+create index messages_created_at_idx on messages (created_at desc);
+
+-- A public chat room: anyone with the app's anon key can read and post.
+-- Before storing private data, add sign-in and scope policies to the user,
+-- e.g. using (user_id::text = current_setting('app.user_id', true)).
+alter table messages enable row level security;
+create policy messages_read on messages for select using (true);
+create policy messages_post on messages for insert with check (true);

package/templates/react-vite-chat/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "lingcode-app",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "backend": "lingcode dev",
+    "deploy:backend": "lingcode deploy"
+  },
+  "dependencies": {
+    "lingcode-js": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^5.0.0",
+    "lingcode": "^0.1.0",
+    "vite": "^7.0.0"
+  }
+}

package/templates/react-vite-chat/src/App.jsx

@@ -0,0 +1,60 @@
+import { useEffect, useState } from 'react';
+import { lingcode } from './lingcode.js';
+
+function useMessages() {
+  const [messages, setMessages] = useState([]);
+  const [error, setError] = useState(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    lingcode.from('messages').order('created_at', { ascending: false }).limit(100).select()
+      .then(({ data, error }) => {
+        if (cancelled) return;
+        if (error) setError(error.message);
+        else setMessages((data || []).reverse());
+      });
+    // Live updates from every open tab, filtered by row-level security.
+    const unsubscribe = lingcode.from('messages').subscribe(({ type, row }) => {
+      if (type !== 'INSERT') return;
+      setMessages((current) => (current.some((m) => m.id === row.id) ? current : [...current, row]));
+    });
+    return () => { cancelled = true; unsubscribe(); };
+  }, []);
+
+  return { messages, error };
+}
+
+export default function App() {
+  const { messages, error } = useMessages();
+  const [author, setAuthor] = useState(() => localStorage.getItem('author') || '');
+  const [body, setBody] = useState('');
+  const [sending, setSending] = useState(false);
+
+  async function send(event) {
+    event.preventDefault();
+    if (!author.trim() || !body.trim()) return;
+    setSending(true);
+    localStorage.setItem('author', author.trim());
+    const { error } = await lingcode.from('messages').insert({ author: author.trim(), body: body.trim() });
+    setSending(false);
+    if (error) alert(error.message);
+    else setBody('');
+  }
+
+  return (
+    <main>
+      <h1>Chat</h1>
+      {error && <p className="error">{error}</p>}
+      <ul className="messages">
+        {messages.map((m) => (
+          <li key={m.id}><strong>{m.author}</strong> {m.body}</li>
+        ))}
+      </ul>
+      <form onSubmit={send}>
+        <input value={author} onChange={(e) => setAuthor(e.target.value)} placeholder="Name" maxLength={40} />
+        <input value={body} onChange={(e) => setBody(e.target.value)} placeholder="Message" maxLength={1000} autoFocus />
+        <button disabled={sending}>Send</button>
+      </form>
+    </main>
+  );
+}

package/templates/react-vite-chat/src/lingcode.js

@@ -0,0 +1,10 @@
+import { createClient } from 'lingcode-js';
+
+const url = import.meta.env.VITE_LINGCODE_URL;
+const anonKey = import.meta.env.VITE_LINGCODE_ANON_KEY;
+
+if (!url || !anonKey) {
+  throw new Error('Missing VITE_LINGCODE_URL / VITE_LINGCODE_ANON_KEY. Run `npx lingcode dev` first; it writes .env.local.');
+}
+
+export const lingcode = createClient(url, anonKey);

package/templates/react-vite-chat/src/main.jsx

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import App from './App.jsx';
+import './styles.css';
+
+createRoot(document.getElementById('root')).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates/react-vite-chat/src/styles.css

@@ -0,0 +1,8 @@
+:root { font-family: system-ui, sans-serif; color-scheme: light dark; }
+main { max-width: 640px; margin: 40px auto; padding: 0 16px; }
+.messages { list-style: none; padding: 0; min-height: 200px; }
+.messages li { padding: 6px 0; border-bottom: 1px solid color-mix(in srgb, currentColor 12%, transparent); }
+form { display: flex; gap: 8px; }
+form input:first-child { width: 120px; }
+form input:nth-child(2) { flex: 1; }
+.error { color: #c0392b; }

package/templates/react-vite-chat/vite.config.js

@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+});