render-create 0.1.0

package/README.md

@@ -0,0 +1,207 @@
+# render-create
+
+CLI tool to scaffold Render projects with Cursor rules, linting configs, and templates. Supports both preset-based and composable project creation.
+
+## Quick Start
+
+```bash
+npx render-create my-app
+```
+
+That's it. You'll get an interactive prompt to choose your stack, and a fully configured project ready to deploy.
+
+## Features
+
+- **One command setup** - Go from zero to deployed in minutes
+- **Infrastructure as Code** - Auto-generated `render.yaml` Blueprint
+- **AI-ready** - Cursor rules for intelligent code assistance
+- **Modern stacks** - Next.js, Fastify, FastAPI, and more
+- **Composable** - Mix frontends, APIs, workers, and databases
+- **Best practices** - Linting, TypeScript, and sensible defaults
+
+## Usage
+
+```bash
+# Interactive mode (recommended)
+npx render-create my-app
+
+# Use a preset directly
+npx render-create my-app --preset fastify-api
+
+# Composable mode - pick your own stack
+npx render-create my-app --composable
+
+# Keep existing project rules in sync
+npx render-create sync
+
+# Check if rules are up to date (CI-friendly)
+npx render-create check --ci
+```
+
+## Available Presets
+
+| Preset           | Stack                          | Database   |
+| ---------------- | ------------------------------ | ---------- |
+| `next-fullstack` | Next.js + Tailwind + Drizzle   | PostgreSQL |
+| `next-frontend`  | Next.js + Tailwind (static)    | -          |
+| `vite-spa`       | Vite + React + Tailwind        | -          |
+| `fastify-api`    | Fastify + Drizzle + Zod        | PostgreSQL |
+| `fastapi`        | FastAPI + SQLAlchemy           | PostgreSQL |
+| `multi-api`      | Fastify + FastAPI side-by-side | -          |
+
+## Composable Mode
+
+Build exactly what you need by mixing components:
+
+```bash
+npx render-create my-app --composable
+```
+
+### Frontends
+
+- **Next.js** - React framework with App Router
+- **Vite** - Fast React SPA
+
+### APIs
+
+- **Fastify** - Node.js with Drizzle ORM
+- **FastAPI** - Python with SQLAlchemy
+
+### Workers
+
+- **Background workers** - TypeScript or Python
+- **Cron jobs** - Scheduled tasks
+- **Workflows** - Render Workflows with SDK
+
+### Infrastructure
+
+- **PostgreSQL** - Managed database
+- **Redis** - Managed cache
+
+## What You Get
+
+Every project includes:
+
+```
+my-app/
+├── src/                    # Your application code
+├── .cursor/rules/          # AI coding assistance rules
+├── render.yaml             # Infrastructure as Code
+├── biome.json / ruff.toml  # Linting configuration
+└── package.json            # Dependencies
+```
+
+### Render Blueprint
+
+The generated `render.yaml` defines your entire infrastructure:
+
+```yaml
+services:
+  - type: web
+    name: my-app
+    runtime: node
+    buildCommand: npm install && npm run build
+    startCommand: npm start
+    healthCheckPath: /health
+    envVars:
+      - key: DATABASE_URL
+        fromDatabase:
+          name: my-app-db
+          property: connectionString
+
+databases:
+  - name: my-app-db
+    postgresMajorVersion: 16
+```
+
+### Cursor Rules
+
+AI-assisted development with framework-specific guidance:
+
+| Rule             | Description                      |
+| ---------------- | -------------------------------- |
+| `general.mdc`    | Project conventions and patterns |
+| `typescript.mdc` | TypeScript best practices        |
+| `react.mdc`      | React and component patterns     |
+| `nextjs.mdc`     | Next.js App Router conventions   |
+| `fastify.mdc`    | Fastify API patterns             |
+| `drizzle.mdc`    | Drizzle ORM usage                |
+| `workflows.mdc`  | Render Workflows SDK             |
+
+## Deploy to Render
+
+After scaffolding, deploy in one click:
+
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy)
+
+Or connect your repo to Render and it will automatically detect the `render.yaml` Blueprint.
+
+## Commands
+
+### `render-create [name]`
+
+Create a new project. If no name is provided, you'll be prompted.
+
+Options:
+
+- `-p, --preset <name>` - Use a preset (skip prompts)
+- `-c, --composable` - Enable composable mode
+- `-y, --yes` - Accept defaults
+
+### `render-create sync`
+
+Update Cursor rules to the latest version.
+
+Options:
+
+- `-f, --force` - Overwrite without prompting
+- `--dry-run` - Preview changes
+
+### `render-create check`
+
+Verify rules are in sync.
+
+Options:
+
+- `--ci` - Exit code 1 if out of sync
+
+## Contributing
+
+We welcome contributions!
+
+```bash
+# Clone and setup
+git clone https://github.com/R4ph-t/render-create-demo.git
+cd render-create-demo
+npm install
+
+# Build and test
+npm run build
+npm test
+
+# Test locally
+npm link
+render-create my-test-app
+```
+
+## Releases
+
+To create a new release:
+
+```bash
+npm run release:patch  # 1.0.0 → 1.0.1
+npm run release:minor  # 1.0.0 → 1.1.0
+npm run release:major  # 1.0.0 → 2.0.0
+```
+
+This will automatically:
+1. Run lint, build, and tests
+2. Bump the version in `package.json`
+3. Create a git commit and tag
+4. Push to GitHub
+
+GitHub Actions will then create a release with auto-generated release notes.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * create-render-app CLI
+ * Scaffold and deploy applications on Render with best practices
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * create-render-app CLI
+ * Scaffold and deploy applications on Render with best practices
+ */
+import { program } from "commander";
+import { check } from "./commands/check.js";
+import { init } from "./commands/init.js";
+import { sync } from "./commands/sync.js";
+program
+    .name("render-create")
+    .description("Scaffold and deploy applications on Render with best practices")
+    .version("0.1.0");
+// Default command: create a new project
+program
+    .argument("[name]", "Project name (creates a new directory)")
+    .option("-p, --preset <preset>", "Use a specific preset (skip prompts)")
+    .option("-c, --composable", "Enable composable mode")
+    .option("-y, --yes", "Accept all defaults")
+    .option("--skip-install", "Skip package installation")
+    .action(init);
+// Explicit init command (alternative syntax)
+program
+    .command("init")
+    .description("Scaffold a new project (same as default command)")
+    .argument("[name]", "Project name (creates a new directory)")
+    .option("-p, --preset <preset>", "Use a specific preset (skip prompts)")
+    .option("-c, --composable", "Enable composable mode")
+    .option("-y, --yes", "Accept all defaults")
+    .option("--skip-install", "Skip package installation")
+    .action(init);
+// Sync command
+program
+    .command("sync")
+    .description("Update local Cursor rules to the latest version")
+    .option("-f, --force", "Overwrite without prompting")
+    .option("--dry-run", "Show changes without applying them")
+    .action(sync);
+// Check command
+program
+    .command("check")
+    .description("Verify Cursor rules are up to date")
+    .option("--ci", "Exit with code 1 if out of sync (for CI)")
+    .action(check);
+program.parse();

package/dist/commands/check.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check command - Verify if local rules are up to date
+ */
+import type { CheckOptions } from "../types.js";
+/**
+ * Main check command handler
+ */
+export declare function check(options: CheckOptions): Promise<void>;

package/dist/commands/check.js

@@ -0,0 +1,96 @@
+/**
+ * Check command - Verify if local rules are up to date
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { compareFiles, getTargetDir, TEMPLATES_DIR } from "../utils.js";
+/**
+ * Main check command handler
+ */
+export async function check(options) {
+    const targetDir = getTargetDir();
+    const rulesDir = join(targetDir, ".cursor", "rules");
+    let inSync = 0;
+    let outOfSync = 0;
+    const _missing = 0;
+    let custom = 0;
+    console.log(chalk.blue("Checking cursor-rules status...\n"));
+    // Check rule files
+    if (existsSync(rulesDir)) {
+        const files = readdirSync(rulesDir);
+        for (const file of files) {
+            if (!file.endsWith(".mdc")) {
+                continue;
+            }
+            const ruleName = file.replace(".mdc", "");
+            const templatePath = `cursor/rules/${ruleName}.mdc`;
+            const targetPath = join(rulesDir, file);
+            // Check if template exists
+            if (!existsSync(join(TEMPLATES_DIR, templatePath))) {
+                console.log(chalk.gray(`  ${file} - custom rule`));
+                custom++;
+                continue;
+            }
+            const result = compareFiles(templatePath, targetPath);
+            if (result.status === "in-sync") {
+                console.log(chalk.green(`  ${file} - up to date`));
+                inSync++;
+            }
+            else if (result.status === "out-of-sync") {
+                console.log(chalk.yellow(`  ${file} - out of sync`));
+                outOfSync++;
+            }
+        }
+    }
+    else {
+        console.log(chalk.yellow("  No .cursor/rules directory found"));
+    }
+    // Check config files
+    const configMappings = [
+        { name: "biome.json", template: "biome.json", target: "biome.json" },
+        { name: "ruff.toml", template: "ruff.toml", target: "ruff.toml" },
+        { name: "tsconfig.base.json", template: "tsconfig.base.json", target: "tsconfig.base.json" },
+    ];
+    for (const config of configMappings) {
+        const targetPath = join(targetDir, config.target);
+        if (!existsSync(targetPath)) {
+            continue; // Skip if not present (might not be needed for this project)
+        }
+        const result = compareFiles(config.template, targetPath);
+        if (result.status === "in-sync") {
+            console.log(chalk.green(`  ${config.name} - up to date`));
+            inSync++;
+        }
+        else if (result.status === "out-of-sync") {
+            console.log(chalk.yellow(`  ${config.name} - out of sync`));
+            outOfSync++;
+        }
+        else if (result.status === "template-missing") {
+            console.log(chalk.gray(`  ${config.name} - custom config`));
+            custom++;
+        }
+    }
+    // Summary
+    console.log();
+    console.log(chalk.blue("Summary:"));
+    console.log(`  ${chalk.green(`${inSync} up to date`)}`);
+    if (outOfSync > 0) {
+        console.log(`  ${chalk.yellow(`${outOfSync} out of sync`)}`);
+    }
+    if (custom > 0) {
+        console.log(`  ${chalk.gray(`${custom} custom (not tracked)`)}`);
+    }
+    // Exit with error code if CI mode and out of sync
+    if (options.ci && outOfSync > 0) {
+        console.log(chalk.red("\nCI check failed: Files are out of sync."));
+        console.log(chalk.gray("Run 'npx @render-examples/cursor-rules sync' to update."));
+        process.exit(1);
+    }
+    if (outOfSync > 0) {
+        console.log(chalk.yellow("\nRun 'npx @render-examples/cursor-rules sync' to update."));
+    }
+    else {
+        console.log(chalk.green("\nAll tracked files are up to date!"));
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Init command - Scaffold a new project with dependencies, Cursor rules, and configs
+ */
+import type { ComponentsConfig, ComposableSelection, InitOptions } from "../types.js";
+/**
+ * Scaffold a composable project with selected components
+ */
+export declare function scaffoldComposableProject(selection: ComposableSelection, components: ComponentsConfig, skipInstall: boolean): Promise<void>;
+/**
+ * Main init command handler
+ */
+export declare function init(nameArg: string | undefined, options: InitOptions): Promise<void>;