feat: add create-spacetime CLI tool

pnpm-workspace.yaml

@@ -4,4 +4,5 @@ packages:
   - 'sdks/typescript/packages/sdk'
   - 'sdks/typescript/packages/test-app'
   - 'sdks/typescript/examples/quickstart-chat'
-  - 'docs'
+  - 'docs'
+  - 'templates/create-spacetime'

templates/create-spacetime/.eslintrc.json

@@ -0,0 +1,19 @@
+{
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-explicit-any": "off",
+    "no-console": "off"
+  },
+  "ignorePatterns": ["dist/", "node_modules/", "spacetime-*/"]
+}

templates/create-spacetime/.gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+*.log
+
+.env*
+
+.DS_Store
+*.tgz
+*.tsbuildinfo

templates/create-spacetime/.npmignore

@@ -0,0 +1,12 @@
+src/
+*.ts
+!*.d.ts
+
+# config files
+.eslintrc*
+.prettierrc*
+tsconfig*.json
+.gitignore
+
+*.log
+*.tsbuildinfo

templates/create-spacetime/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "printWidth": 100,
+  "tabWidth": 2
+}

templates/create-spacetime/README.md

@@ -0,0 +1,77 @@
+# create-spacetime
+
+## Overview
+
+This package contains the official CLI tool for creating SpacetimeDB projects. The CLI allows you to quickly scaffold new SpacetimeDB applications with a template of your choice (React frontends with Rust or C# backends).
+
+## Installation
+
+To create a new SpacetimeDB project:
+
+```bash
+npm create spacetime@latest
+```
+
+## Usage
+
+To create a project you can run the interactive setup or specify options directly.
+
+```bash
+npm create spacetime@latest my-spacetime-app -- -t rust
+```
+
+Skip interactive prompts with `-y` (defaults server language to Rust):
+
+```bash
+npm create spacetime@latest my-spacetime-app -- -y
+```
+
+The `-t` flag selects your server language template.
+
+Available templates:
+
+- `rust` - Rust server with React client
+- `csharp` - C# server with React client
+
+Create in your current directory using `.` as the project name:
+
+```sh
+npm create spacetime@latest .
+```
+
+Use a local SpacetimeDB server instead of Maincloud:
+
+```bash
+npm create spacetime@latest my-spacetime-app -- --local
+```
+
+## What You Get
+
+Creates a full-stack SpacetimeDB app with server module and React frontend, including build scripts and example chat app.
+
+## Requirements
+
+- Node.js 18+ and npm 8+
+- SpacetimeDB CLI (optional for creation, required for Maincloud deployment) - [spacetimedb.com/install](https://spacetimedb.com/install)
+
+## Running The Project
+
+After project creation:
+
+```bash
+cd my-spacetime-app
+npm run dev
+```
+
+Your React app will be available at `http://localhost:5173`.
+
+To deploy your SpacetimeDB module:
+
+```bash
+npm run local    # Local deployment
+npm run deploy   # Deploy to Maincloud
+```
+
+## Learn More
+
+- [SpacetimeDB Documentation](https://spacetimedb.com/docs)

templates/create-spacetime/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "create-spacetime",
+  "version": "0.0.4",
+  "type": "module",
+  "author": {
+    "name": "Clockwork Labs",
+    "email": "no-reply@clockworklabs.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clockworklabs/SpacetimeDB.git",
+    "directory": "templates/create-spacetime"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "bin": {
+    "create-spacetime": "./dist/index.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write src/**/*.ts src/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run clean && npm run lint && npm run format:check && npm run build",
+    "size-check": "npm pack --dry-run",
+    "test": "npm run build && node dist/index.js test-app --dry-run"
+  },
+  "dependencies": {
+    "chalk": "^5.3.2",
+    "commander": "^12.0.0",
+    "cross-spawn": "^7.0.3",
+    "degit": "^2.8.4",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.15",
+    "ora": "^8.0.1",
+    "validate-npm-package-name": "^5.0.0",
+    "which": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/degit": "^2.8.6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.24",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "@types/which": "^3.0.3",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5",
+    "typescript": "^5.5.4"
+  }
+}