create-sonicjs 2.0.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SonicJS Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,291 @@
+# create-sonicjs-app
+
+> The easiest way to create a new SonicJS application
+
+[![Version](https://img.shields.io/npm/v/create-sonicjs-app)](https://www.npmjs.com/package/create-sonicjs-app)
+[![License](https://img.shields.io/npm/l/create-sonicjs-app)](./LICENSE)
+
+## Quick Start
+
+```bash
+npx create-sonicjs-app my-app
+```
+
+That's it! Follow the interactive prompts and you'll have a running SonicJS application in minutes.
+
+## What It Does
+
+`create-sonicjs-app` sets up everything you need for a modern headless CMS on Cloudflare's edge:
+
+- ✅ **Project scaffolding** - Complete project structure
+- ✅ **Template selection** - Choose from pre-built templates
+- ✅ **Cloudflare resources** - Optionally create D1 database and R2 bucket
+- ✅ **Configuration** - Auto-configured wrangler.toml
+- ✅ **Dependencies** - Installs all required packages
+- ✅ **Git initialization** - Ready for version control
+- ✅ **Example code** - Optional blog collection example
+
+## Usage
+
+### Interactive Mode (Recommended)
+
+```bash
+npx create-sonicjs-app
+```
+
+You'll be prompted for:
+- Project name
+- Template choice
+- Database name
+- R2 bucket name
+- Whether to include examples
+- Whether to create Cloudflare resources
+- Whether to initialize git
+
+### With Project Name
+
+```bash
+npx create-sonicjs-app my-blog
+```
+
+### Command Line Options
+
+```bash
+npx create-sonicjs-app my-app --template=starter --skip-install
+```
+
+**Available flags:**
+- `--template=<name>` - Skip template selection (e.g., `--template=starter`)
+- `--database=<name>` - Set database name without prompt
+- `--bucket=<name>` - Set R2 bucket name without prompt
+- `--include-example` - Include example blog collection (no prompt)
+- `--skip-example` - Skip example blog collection (no prompt)
+- `--skip-install` - Don't install dependencies
+- `--skip-git` - Don't initialize git
+- `--skip-cloudflare` - Don't prompt for Cloudflare resource creation
+
+## Templates
+
+### Starter (Default)
+Perfect for blogs, documentation, and content sites.
+
+Includes:
+- Blog collection example
+- Admin dashboard
+- REST API
+- Media management
+
+**Coming Soon:**
+- E-commerce template
+- Documentation site template
+- Portfolio template
+
+## Requirements
+
+- **Node.js** 18 or higher
+- **npm** 7 or higher (or yarn/pnpm)
+- **wrangler** (optional, for Cloudflare resources)
+
+## What Gets Created
+
+```
+my-app/
+├── src/
+│   ├── index.ts              # Application entry point
+│   └── collections/          # Content type definitions
+│       └── blog-posts.collection.ts
+├── wrangler.toml             # Cloudflare Workers config
+├── package.json              # Dependencies
+├── tsconfig.json             # TypeScript config
+├── .gitignore
+└── README.md
+```
+
+## After Creation
+
+### 1. Navigate to your project
+
+```bash
+cd my-app
+```
+
+### 2. Create Cloudflare resources (if skipped)
+
+```bash
+wrangler d1 create my-app-db
+# Copy the database_id to wrangler.toml
+
+wrangler r2 bucket create my-app-media
+```
+
+### 3. Run database migrations
+
+```bash
+npm run db:migrate:local
+```
+
+### 4. Start development server
+
+```bash
+npm run dev
+```
+
+### 5. Open admin interface
+
+Visit http://localhost:8787/admin
+
+Default credentials:
+- Email: `admin@sonicjs.com`
+- Password: `admin`
+
+## Package Managers
+
+Works with all major package managers:
+
+```bash
+# npm
+npx create-sonicjs-app my-app
+
+# yarn
+yarn create sonicjs-app my-app
+
+# pnpm
+pnpm create sonicjs-app my-app
+```
+
+The CLI automatically detects your package manager from lock files.
+
+## Environment Variables
+
+After creation, you may want to set up environment variables:
+
+```bash
+# .dev.vars (for local development)
+ENVIRONMENT=development
+```
+
+## Cloudflare Resources
+
+### D1 Database
+
+If you create resources during setup, a D1 database is automatically created and configured.
+
+**Manual creation:**
+```bash
+wrangler d1 create my-app-db
+```
+
+### R2 Bucket
+
+For media storage, an R2 bucket is created.
+
+**Manual creation:**
+```bash
+wrangler r2 bucket create my-app-media
+```
+
+## Troubleshooting
+
+### "wrangler is not installed"
+
+Install wrangler globally:
+```bash
+npm install -g wrangler
+```
+
+### "Directory already exists"
+
+Choose a different project name or remove the existing directory:
+```bash
+rm -rf my-app
+```
+
+### Dependencies fail to install
+
+Try manually:
+```bash
+cd my-app
+npm install
+```
+
+### Cloudflare resource creation fails
+
+You can create resources manually after project creation. See the [After Creation](#after-creation) section.
+
+## Advanced Usage
+
+### Skip All Prompts (Non-Interactive Mode)
+
+```bash
+npx create-sonicjs-app my-app \
+  --template=starter \
+  --database=my-app-db \
+  --bucket=my-app-media \
+  --include-example \
+  --skip-install \
+  --skip-git \
+  --skip-cloudflare
+```
+
+### Use in CI/CD
+
+```bash
+npx create-sonicjs-app test-app \
+  --template=starter \
+  --database=test-db \
+  --bucket=test-bucket \
+  --skip-example \
+  --skip-install \
+  --skip-cloudflare \
+  --skip-git
+```
+
+## Features
+
+- 🎨 **Beautiful CLI** - Colored output and progress indicators
+- ⚡ **Fast** - Optimized for speed
+- 🔒 **Type-safe** - Full TypeScript support
+- 🌐 **Edge-first** - Built for Cloudflare Workers
+- 📦 **Zero config** - Works out of the box
+- 🔧 **Customizable** - Easy to extend
+
+## Examples
+
+### Create a blog
+
+```bash
+npx create-sonicjs-app my-blog
+# Select "Starter" template
+# Include example collection: Yes
+```
+
+### Create without examples
+
+```bash
+npx create-sonicjs-app my-app
+# Include example collection: No
+```
+
+## Related
+
+- [@sonicjs-cms/core](../core) - Core framework
+- [SonicJS Documentation](https://docs.sonicjs.com)
+- [Cloudflare Workers](https://workers.cloudflare.com)
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## License
+
+MIT © SonicJS Team
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/sonicjs/sonicjs/issues)
+- **Discord**: [Join our community](https://discord.gg/sonicjs)
+- **Docs**: [docs.sonicjs.com](https://docs.sonicjs.com)
+
+---
+
+**Built with ❤️ for developers** | v2.0.0-alpha.1

package/bin/create-sonicjs-app.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../src/cli.js'

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-sonicjs",
+  "version": "2.0.0-alpha.2",
+  "description": "Create a new SonicJS application with zero configuration",
+  "type": "module",
+  "bin": {
+    "create-sonicjs-app": "./bin/create-sonicjs-app.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates"
+  ],
+  "scripts": {
+    "build": "echo 'No build needed for CLI'",
+    "test": "node test-cli.js"
+  },
+  "keywords": [
+    "sonicjs",
+    "cms",
+    "create-app",
+    "scaffolding",
+    "cloudflare",
+    "workers",
+    "edge",
+    "headless-cms"
+  ],
+  "author": "SonicJS Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sonicjs/sonicjs.git",
+    "directory": "packages/create-app"
+  },
+  "bugs": {
+    "url": "https://github.com/sonicjs/sonicjs/issues"
+  },
+  "homepage": "https://sonicjs.com",
+  "dependencies": {
+    "prompts": "^2.4.2",
+    "kleur": "^4.1.5",
+    "ora": "^8.0.1",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.2.0",
+    "validate-npm-package-name": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}