render-create 0.1.0

package/templates/LINTING_SETUP.md

@@ -0,0 +1,205 @@
+# Linting and formatting setup
+
+Standard configuration for consistent code style across projects. Uses fast, Rust-based tools for both TypeScript and Python.
+
+## Tools
+
+| Language | Tool | Purpose |
+|----------|------|---------|
+| TypeScript | [Biome](https://biomejs.dev/) | Linting + formatting |
+| Python | [Ruff](https://docs.astral.sh/ruff/) | Linting + formatting |
+
+## TypeScript setup (Biome)
+
+### 1. Create `biome.json` at project root
+
+```json
+{
+  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noNonNullAssertion": "off"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  },
+  "files": {
+    "includes": ["src/**/*.ts", "src/**/*.tsx"]
+  }
+}
+```
+
+Adjust `files.includes` based on your project structure.
+
+### 2. Add Biome to each TypeScript package
+
+In each `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "biome lint src/",
+    "format": "biome format --write src/",
+    "check": "biome check --write src/"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0"
+  }
+}
+```
+
+### 3. Install and run
+
+```bash
+npm install
+npm run check
+```
+
+## Python setup (Ruff)
+
+### 1. Create `ruff.toml` at project root
+
+```toml
+# Ruff configuration for Python linting and formatting
+# https://docs.astral.sh/ruff/
+
+line-length = 100
+target-version = "py312"
+
+[lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "SIM",    # flake8-simplify
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "B008",   # do not perform function calls in argument defaults
+    "SIM108", # ternary operator (can reduce readability)
+]
+
+[lint.isort]
+known-first-party = ["your-package-name"]
+
+[format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+```
+
+### 2. Add Ruff to requirements
+
+In each `requirements.txt`:
+
+```
+ruff>=0.8.0
+```
+
+### 3. Run Ruff
+
+```bash
+# Check for issues
+ruff check .
+
+# Auto-fix issues
+ruff check --fix .
+
+# Format code
+ruff format .
+
+# Or run both
+ruff check --fix . && ruff format .
+```
+
+## What the tools enforce
+
+| Category | Enforced | Examples |
+|----------|----------|----------|
+| Formatting | Yes | Indentation, quotes, semicolons, line length |
+| Import sorting | Yes | Alphabetical, grouped by type |
+| Unused code | Yes | Unused variables, unreachable code |
+| Bug prevention | Yes | Type coercion issues, null checks |
+| Comments | No | See [STYLE_GUIDE.md](./STYLE_GUIDE.md) |
+| Function style | No | See [STYLE_GUIDE.md](./STYLE_GUIDE.md) |
+| Code organization | No | See [STYLE_GUIDE.md](./STYLE_GUIDE.md) |
+
+## Formatting defaults
+
+| Setting | Value |
+|---------|-------|
+| Indentation | 2 spaces (TS), 4 spaces (Python) |
+| Line length | 100 characters |
+| Quotes | Double quotes |
+| Semicolons | Always (TypeScript) |
+| Trailing commas | Yes |
+
+For code style conventions (comments, functions, naming, etc.), see **[STYLE_GUIDE.md](./STYLE_GUIDE.md)**.
+
+## IDE integration
+
+### VS Code
+
+Install extensions:
+- **Biome**: `biomejs.biome`
+- **Ruff**: `charliermarsh.ruff`
+
+Both extensions provide format-on-save and inline error highlighting.
+
+### Cursor
+
+Biome and Ruff extensions work the same as VS Code.
+
+## CI integration (optional)
+
+Add to your CI pipeline:
+
+```yaml
+# TypeScript
+- name: Lint TypeScript
+  run: npx @biomejs/biome check src/
+
+# Python
+- name: Lint Python
+  run: |
+    pip install ruff
+    ruff check .
+    ruff format --check .
+```
+
+## Migrating existing projects
+
+1. Install the tools
+2. Run with auto-fix enabled
+3. Review changes
+4. Commit
+
+```bash
+# TypeScript
+npm install @biomejs/biome --save-dev
+npx @biomejs/biome check --write .
+
+# Python
+pip install ruff
+ruff check --fix .
+ruff format .
+```

package/templates/README_TEMPLATE.md

@@ -0,0 +1,68 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/render-examples/{{PROJECT_NAME}}.git
+cd {{PROJECT_NAME}}
+
+# Install dependencies
+npm install  # or: pip install -r requirements.txt
+
+# Set up environment
+cp .env.example .env
+# Edit .env with your values
+
+# Run the application
+npm run dev  # or: python app.py
+```
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `DATABASE_URL` | PostgreSQL connection string | Yes |
+| `API_KEY` | External API key | Yes |
+
+See `.env.example` for all variables.
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── src/              # Source code
+├── tests/            # Test files
+├── docs/             # Documentation
+└── README.md
+```
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+```
+
+## Deployment
+
+This project is configured for deployment on [Render](https://render.com).
+
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy)
+
+## Links
+
+- [Render Docs](https://docs.render.com)
+- [GitHub Repository](https://github.com/render-examples/{{PROJECT_NAME}})
+
+## License
+
+MIT

package/templates/STYLE_GUIDE.md

@@ -0,0 +1,241 @@
+# Code Style Guide
+
+Style conventions for projects. These patterns are **not enforced by tooling** and must be followed manually.
+
+For automated linting/formatting setup, see [LINTING_SETUP.md](./LINTING_SETUP.md).
+
+## Functions
+
+### TypeScript: Use named functions for exports
+
+```typescript
+// Good
+export function handleRequest(req: Request): Response {
+  // ...
+}
+
+export async function fetchUserData(userId: string): Promise<User> {
+  // ...
+}
+
+// Avoid
+export const handleRequest = (req: Request): Response => {
+  // ...
+};
+```
+
+Arrow functions are fine for:
+- Callbacks: `items.map((item) => item.id)`
+- Simple internal helpers: `const clean = (s: string) => s.trim()`
+
+### Python: Use regular function definitions
+
+```python
+# Good
+def handle_request(request: Request) -> Response:
+    ...
+
+async def fetch_user_data(user_id: str) -> User:
+    ...
+```
+
+## Comments and documentation
+
+### When to add comments
+
+Add comments **liberally to help future readers**, but focus on explaining context and reasoning rather than restating code.
+
+```typescript
+// Good: Explains WHY
+const timeout = 30000; // Extended timeout for slow upstream API
+
+// Good: Provides context
+// pMap limits concurrency to avoid overwhelming the API
+const results = await pMap(items, processItem, { concurrency: 5 });
+
+// Avoid: Restates the code
+const timeout = 30000; // Set timeout to 30000
+```
+
+### JSDoc / Docstrings
+
+Add documentation **when behavior is non-obvious**. Self-explanatory functions don't need docs.
+
+**TypeScript:**
+```typescript
+// Needs doc: Non-obvious behavior
+/** Fetches title, trying og:title, twitter:title, then <title> tag. */
+export function fetchBlogTitle(url: string): Promise<string> {
+  // ...
+}
+
+// No doc needed: Self-explanatory
+export function getHealthStatus(): HealthStatus {
+  return { status: "ok" };
+}
+```
+
+**Python:**
+```python
+# Needs doc: Non-obvious behavior
+def fetch_blog_title(url: str) -> str:
+    """Fetch title, trying og:title, twitter:title, then <title> tag."""
+    ...
+
+# No doc needed: Self-explanatory
+def get_health_status() -> dict:
+    return {"status": "ok"}
+```
+
+### File headers
+
+Add a header comment **only to main entry files** (`index.ts`, `app.py`, `main.py`):
+
+```typescript
+/**
+ * Project Name API
+ * Entry point: server setup, middleware, and routes.
+ */
+```
+
+```python
+"""
+Project Name API
+Entry point: server setup, middleware, and routes.
+"""
+```
+
+Other files should have self-explanatory names (e.g., `storage.ts`, `handlers.py`).
+
+## Error handling
+
+Use **both patterns** depending on context:
+
+### Early return for validation
+
+```typescript
+export function processRequest(data: unknown): Result {
+  if (!data) {
+    return { error: "Data is required" };
+  }
+  if (!isValid(data)) {
+    return { error: "Invalid data format" };
+  }
+  
+  // Main logic here
+  return { success: true, result: transform(data) };
+}
+```
+
+### Try-catch for external operations
+
+```typescript
+export async function fetchData(url: string): Promise<Data> {
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return await response.json();
+  } catch (error) {
+    logFullError("Fetch failed", error);
+    throw error;
+  }
+}
+```
+
+## Async code
+
+### Always use async/await
+
+```typescript
+// Good
+async function fetchAndProcess(url: string): Promise<Result> {
+  const response = await fetch(url);
+  const data = await response.json();
+  return processData(data);
+}
+
+// Avoid
+function fetchAndProcess(url: string): Promise<Result> {
+  return fetch(url)
+    .then((response) => response.json())
+    .then((data) => processData(data));
+}
+```
+
+## Logging
+
+### Use prefixed log messages
+
+Include the module/component name in brackets:
+
+```typescript
+console.log("[API] Starting server on port 8080");
+console.log("[storage] Creating bucket: thumbnails");
+console.error("[handler] Failed to process request:", error);
+```
+
+```python
+print("[API] Starting server on port 8080")
+print("[storage] Creating bucket: thumbnails")
+print(f"[handler] Failed to process request: {error}")
+```
+
+## Naming
+
+### Balanced verbosity
+
+Names should be clear but not excessively long:
+
+```typescript
+// Good: Balanced
+const accountStatus = getAccountStatus();
+const blogTitle = await fetchBlogTitle(url);
+const taskResult = await runTask(input);
+
+// Too verbose
+const userAccountStatusFromDatabase = getUserAccountStatusFromDatabase();
+
+// Too terse
+const s = getStatus();
+const t = fetchTitle(u);
+```
+
+### Conventions by language
+
+**TypeScript:**
+- Variables/functions: `camelCase`
+- Types/interfaces/classes: `PascalCase`
+- Constants: `SCREAMING_SNAKE_CASE`
+
+**Python:**
+- Variables/functions: `snake_case`
+- Classes: `PascalCase`
+- Constants: `SCREAMING_SNAKE_CASE`
+
+## Imports
+
+Let **Biome (TypeScript)** and **Ruff (Python)** handle import organization automatically. Run:
+
+```bash
+# TypeScript
+npm run check
+
+# Python
+ruff check --fix . && ruff format .
+```
+
+## Summary
+
+| Aspect | Convention |
+|--------|------------|
+| Functions | Named exports (TS), regular defs (Python) |
+| Comments | Liberal, explain WHY and context |
+| Docs | Only when non-obvious |
+| File headers | Only entry files |
+| Error handling | Early return + try-catch |
+| Async | Always async/await |
+| Logging | Prefixed: `[module] message` |
+| Naming | Balanced verbosity |
+| Imports | Let tooling handle |

package/templates/assets/favicon.svg

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 800 800">
+  <!-- Generator: Adobe Illustrator 30.0.0, SVG Export Plug-In . SVG Version: 2.1.1 Build 123)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #fff;
+      }
+
+      .st1 {
+        fill: #8a05ff;
+      }
+    </style>
+  </defs>
+  <rect class="st1" width="800" height="800"/>
+  <path class="st0" d="M654.17,263.04c-.07-1.7-.22-3.36-.37-5.06-.04-.41-.04-.85-.11-1.26-.11-1.03-.26-2.03-.41-3.07-.15-1.07-.26-2.11-.41-3.14-.11-.74-.26-1.48-.41-2.18-.22-1.29-.44-2.62-.7-3.91-.22-1.03-.48-2.03-.7-3.07-.22-1-.44-1.96-.66-2.95-.26-1.03-.59-2.03-.89-3.07-.26-.96-.52-1.88-.81-2.84-.33-1.03-.7-2.07-1.07-3.1-.3-.89-.59-1.77-.89-2.66-.48-1.29-1-2.55-1.48-3.8-.26-.63-.48-1.22-.74-1.85-.59-1.37-1.18-2.7-1.81-4.03-.22-.48-.44-1-.66-1.48-.59-1.26-1.26-2.47-1.88-3.69-.3-.55-.55-1.11-.85-1.66-.74-1.37-1.55-2.73-2.33-4.06-.22-.37-.41-.74-.63-1.11-.85-1.4-1.74-2.77-2.66-4.14-.19-.3-.37-.59-.56-.89-1.11-1.63-2.25-3.25-3.44-4.84-1.11-1.48-2.25-2.96-3.44-4.4-.07-.11-.15-.22-.26-.33-22.84-27.67-57.31-45.25-95.93-45.28v-.07l-.11.07h.04c-10.72,0-21.14,1.37-31.08,3.92-5.95,1.52-11.75,3.51-17.33,5.84-1.85.78-3.7,1.62-5.51,2.47-36.69,17.65-63.3,52.82-69.17,94.63h-.07c-2.59,17.91-8.09,34.87-15.93,50.46h.26c-27.27,54.07-83.29,91.2-148.03,91.2-28.9,0-56.02-7.39-79.67-20.35-2.77-1.52-6.13.48-6.13,3.62v16.73h-.26v248.47h248.62v-124.25h.26v-62.13c0-34.31,27.83-62.13,62.15-62.13h62.15c10.64,0,20.95-1.37,30.82-3.92,5.95-1.55,11.75-3.51,17.33-5.84,1.85-.78,3.7-1.62,5.51-2.47,38.02-18.32,65.3-55.44,69.77-99.29.41-4.17.63-8.42.63-12.71,0-2.14-.04-4.28-.15-6.39Z"/>
+</svg>

package/templates/biome.json

@@ -0,0 +1,43 @@
+{
+  "root": false,
+  "$schema": "https://biomejs.dev/schemas/2.3.14/schema.json",
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noNonNullAssertion": "off"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  },
+  "css": {
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "space",
+      "indentWidth": 2
+    },
+    "linter": {
+      "enabled": true
+    },
+    "parser": {
+      "cssModules": true,
+      "tailwindDirectives": true
+    }
+  },
+  "files": {
+    "includes": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.css", "app/**/*.css"]
+  }
+}