create-ely 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Create Ely
+
+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,50 @@
+# create-ely
+
+Scaffold ElysiaJS projects with ease using [Bun](https://bun.sh).
+
+## Usage
+
+Create a new ElysiaJS project:
+
+```bash
+bunx create-ely my-project
+```
+
+You'll be prompted to choose between:
+
+- **Backend only** - ElysiaJS API with PostgreSQL, Drizzle ORM
+- **Monorepo** - Backend + Frontend (React with TanStack Router)
+
+## Templates
+
+### Backend Only
+
+A production-ready ElysiaJS backend with:
+
+- PostgreSQL database with Drizzle ORM
+- Type-safe API with OpenAPI documentation
+- Global error handling
+- Structured logging with Pino
+- Docker support
+- Environment validation
+
+### Monorepo
+
+Full-stack setup with:
+
+- Backend: Everything from Backend Only template
+- Frontend: React + TanStack Router + Vite
+- Workspace configuration with Bun
+
+## Development
+
+To test the CLI locally:
+
+```bash
+bun link
+bunx create-ely
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "create-ely",
+  "version": "0.1.1",
+  "description": "Scaffold production-ready ElysiaJS projects with ease using Bun - choose between backend-only or full-stack monorepo templates",
+  "type": "module",
+  "author": {
+    "name": "truehazker",
+    "url": "https://github.com/truehazker"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/truehazker/create-ely.git"
+  },
+  "homepage": "https://github.com/truehazker/create-ely#readme",
+  "bugs": {
+    "url": "https://github.com/truehazker/create-ely/issues"
+  },
+  "keywords": [
+    "elysiajs",
+    "elysia",
+    "bun",
+    "template",
+    "scaffold",
+    "cli",
+    "create",
+    "generator",
+    "boilerplate",
+    "starter",
+    "monorepo",
+    "fullstack",
+    "backend",
+    "drizzle",
+    "postgresql",
+    "react",
+    "tanstack-router"
+  ],
+  "bin": {
+    "create-ely": "./src/index.ts"
+  },
+  "files": ["src", "templates", "README.md", "LICENSE"],
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --compile --outfile dist/create-ely"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "@types/bun": "^1.3.5"
+  }
+}

package/src/index.ts

@@ -0,0 +1,187 @@
+#!/usr/bin/env bun
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  rmSync,
+  statSync,
+} from 'node:fs';
+import { dirname, join } from 'node:path';
+import * as clack from '@clack/prompts';
+
+async function main() {
+  console.clear();
+
+  clack.intro('create-ely');
+
+  // Check if project name was passed as argument
+  const args = process.argv.slice(2);
+  const projectNameArg = args[0];
+
+  const projectType = await clack.select({
+    message: 'What would you like to create?',
+    options: [
+      {
+        value: 'backend',
+        label: 'Backend only',
+        hint: 'ElysiaJS API with PostgreSQL',
+      },
+      {
+        value: 'monorepo',
+        label: 'Monorepo',
+        hint: 'Backend + Frontend (React + TanStack Router)',
+      },
+    ],
+  });
+
+  if (clack.isCancel(projectType)) {
+    clack.cancel('Operation cancelled');
+    process.exit(0);
+  }
+
+  let projectName: string | symbol;
+
+  // If project name was provided as argument and is valid, use it
+  if (projectNameArg && /^[a-z0-9-]+$/.test(projectNameArg)) {
+    projectName = projectNameArg;
+  } else {
+    // Otherwise, prompt for it
+    projectName = await clack.text({
+      message: 'Project name:',
+      placeholder: 'my-elysia-app',
+      validate: (value) => {
+        if (!value) return 'Project name is required';
+        if (!/^[a-z0-9-]+$/.test(value))
+          return 'Project name must contain only lowercase letters, numbers, and hyphens';
+        return undefined;
+      },
+    });
+
+    if (clack.isCancel(projectName)) {
+      clack.cancel('Operation cancelled');
+      process.exit(0);
+    }
+  }
+
+  const targetDir = join(process.cwd(), projectName as string);
+
+  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    const shouldOverwrite = await clack.confirm({
+      message: `Directory "${String(projectName)}" already exists and is not empty. Overwrite it?`,
+      initialValue: false,
+    });
+
+    if (clack.isCancel(shouldOverwrite) || !shouldOverwrite) {
+      clack.cancel('Operation cancelled');
+      process.exit(0);
+    }
+
+    rmSync(targetDir, { recursive: true, force: true });
+  }
+
+  const spinner = clack.spinner();
+  spinner.start('Creating project...');
+
+  try {
+    const templateDir = join(
+      import.meta.dir,
+      '..',
+      'templates',
+      projectType as string,
+    );
+
+    // Cross-platform recursive copy function
+    function copyRecursive(src: string, dest: string, exclude: string[] = []) {
+      const stats = statSync(src);
+
+      if (stats.isDirectory()) {
+        if (!existsSync(dest)) {
+          mkdirSync(dest, { recursive: true });
+        }
+
+        for (const entry of readdirSync(src)) {
+          if (exclude.includes(entry) || entry.endsWith('.template')) continue;
+
+          const srcPath = join(src, entry);
+          const destPath = join(dest, entry);
+          copyRecursive(srcPath, destPath, exclude);
+        }
+      } else {
+        const destDir = dirname(dest);
+        if (!existsSync(destDir)) {
+          mkdirSync(destDir, { recursive: true });
+        }
+        copyFileSync(src, dest);
+      }
+    }
+
+    copyRecursive(templateDir, targetDir, ['node_modules', '.git']);
+
+    // Handle template files: copy them to their intended locations
+    if (projectType === 'monorepo') {
+      const backendBiomeTemplate = join(
+        templateDir,
+        'apps',
+        'backend-biome.json.template',
+      );
+      const backendBiomeTarget = join(
+        targetDir,
+        'apps',
+        'backend',
+        'biome.json',
+      );
+
+      if (existsSync(backendBiomeTemplate)) {
+        copyFileSync(backendBiomeTemplate, backendBiomeTarget);
+      }
+    }
+
+    spinner.stop('Project created successfully!');
+
+    const s = clack.spinner();
+    s.start('Installing dependencies...');
+
+    // Install dependencies
+    const installProc = Bun.spawn(['bun', 'install'], {
+      cwd: targetDir,
+      stdout: 'inherit',
+      stderr: 'inherit',
+    });
+    await installProc.exited;
+
+    if (installProc.exitCode !== 0) {
+      throw new Error('Failed to install dependencies');
+    }
+
+    s.stop('Dependencies installed!');
+
+    const nextSteps =
+      projectType === 'monorepo'
+        ? `  cd ${String(projectName)}
+  bun run dev:backend  # Start backend on http://localhost:3000
+  bun run dev:frontend # Start frontend on http://localhost:5173`
+        : `  cd ${String(projectName)}
+  bun run dev          # Start backend on http://localhost:3000`;
+
+    clack.outro(`
+Success! Your ElysiaJS project is ready.
+
+Next steps:
+${nextSteps}
+
+Check out the README.md for more information.
+    `);
+  } catch (error) {
+    spinner.stop('Failed to create project');
+    clack.cancel(
+      error instanceof Error ? error.message : 'Unknown error occurred',
+    );
+    process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/templates/monorepo/README.md

@@ -0,0 +1,75 @@
+# Monorepo Template
+
+This is a monorepo template containing a full-stack application with a backend (ElysiaJS) and frontend (React) application.
+
+## Getting Started
+
+### Prerequisites
+
+- [Bun](https://bun.sh) (latest version)
+- [Podman](https://podman.io) (for running auxiliary services)
+
+### Setup Steps
+
+1. **Install dependencies**
+
+   ```bash
+   bun install
+   ```
+
+2. **Configure environment variables**
+
+   Each app requires its own `.env` file. Please check each app's README for specific environment variable requirements:
+
+   - **Backend**: See [apps/backend/README.md](./apps/backend/README.md) for required environment variables (e.g., `DATABASE_URL`, `SERVER_PORT`, etc.)
+   - **Frontend**: See [apps/frontend/README.md](./apps/frontend/README.md) for required environment variables (e.g., `VITE_API_URL`)
+
+3. **Start auxiliary services with Podman**
+
+   The backend requires a PostgreSQL database. You can start it using Podman or Docker:
+
+   ```bash
+   cd apps/backend
+   podman compose up -d elysia-boilerplate-postgres
+   ```
+
+   This will start a PostgreSQL database container that the backend application can connect to.
+
+4. **Run database migrations**
+
+   ```bash
+   cd apps/backend
+   bun run db:migrate
+   ```
+
+5. **Start the applications**
+
+   In separate terminals:
+
+   ```bash
+   # Terminal 1: Start backend
+   cd apps/backend
+   bun run dev
+
+   # Terminal 2: Start frontend
+   cd apps/frontend
+   bun run dev
+   ```
+
+## Project Structure
+
+```text
+.
+├── apps/
+│   ├── backend/     # ElysiaJS API server
+│   └── frontend/    # React frontend application
+├── package.json     # Root package.json for workspace management
+└── README.md        # This file
+```
+
+## Additional Information
+
+For more detailed information about each application, please refer to their respective README files:
+
+- [Backend README](./apps/backend/README.md)
+- [Frontend README](./apps/frontend/README.md)

package/templates/monorepo/apps/backend/.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
+}

package/templates/monorepo/apps/backend/.dockerignore

@@ -0,0 +1,60 @@
+# Ignore files that shouldn't be in the Docker build context
+# Following best practices from Dejan Gegić's optimization guide
+
+# Version control
+.git
+.gitignore
+
+# Dependencies (will be installed in container)
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment and secrets
+.env
+.env.local
+.env.*.local
+*.pem
+
+# Build outputs (except what we explicitly copy)
+build
+dist
+coverage
+
+# IDE and editor files
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Documentation
+README.md
+CHANGELOG.md
+LICENSE
+*.md
+
+# Docker files
+Dockerfile*
+docker-compose*.yml
+
+# Test files
+**/*.test.*
+**/*.spec.*
+tests/
+test/
+
+# Logs
+logs
+*.log
+

package/templates/monorepo/apps/backend/.env.example

@@ -0,0 +1,19 @@
+# Application Environment
+NODE_ENV=development
+
+# Logging Configuration
+LOG_LEVEL=debug
+
+# Server Configuration
+SERVER_HOSTNAME=localhost
+SERVER_PORT=3000
+
+# Database Configuration
+# Replace with your actual PostgreSQL connection details
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/elysia-boilerplate
+
+# Enable migrations on server startup
+DB_AUTO_MIGRATE=false
+
+# Enable OpenAPI documentation to be available on /openapi route
+ENABLE_OPENAPI=true

package/templates/monorepo/apps/backend/.github/workflows/lint.yml

@@ -0,0 +1,31 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  lint:
+    name: Biome Lint Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run Biome linter
+        run: bun run lint

package/templates/monorepo/apps/backend/.github/workflows/tests.yml

@@ -0,0 +1,36 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Prepare environment variables
+        run: |
+          echo "NODE_ENV=test" >> $GITHUB_ENV
+          echo "DATABASE_URL=${{ secrets.DATABASE_URL }}" >> $GITHUB_ENV
+
+      - name: Run tests
+        run: bun test

package/templates/monorepo/apps/backend/AGENTS.md

@@ -0,0 +1,79 @@
+# AGENTS.md
+
+## Project Overview
+
+This is an ElysiaJS boilerplate project using Bun, PostgreSQL, and Drizzle ORM.
+It follows a modular architecture with strict TypeScript configuration.
+
+## Tech Stack
+
+- **Runtime**: Bun
+- **Framework**: ElysiaJS
+- **Database**: PostgreSQL
+- **ORM**: Drizzle ORM
+- **Linter/Formatter**: Biome
+- **Testing**: Bun Test
+- **Containerization**: Docker
+
+## Recommended Tools
+
+- **VS Code Extensions**:
+  - `biomejs.biome` (Formatter & Linter)
+  - `vivaxy.vscode-conventional-commits` (Commit messages)
+  - `ms-vscode.cmake-tools` (Build tools)
+- **MCP Services**:
+  - PostgreSQL MCP (for database context)
+  - GitHub MCP (for PR/Issue context)
+
+## Setup & Commands
+
+- **Install dependencies**: `bun install`
+- **Start dev server**: `bun run dev`
+- **Build for production**: `bun run build`
+- **Start production server**: `bun run start`
+- **Run tests**: `bun test`
+- **Lint code**: `bun run lint`
+- **Format code**: `bun run format`
+
+## Database Operations
+
+- **Generate migrations**: `bun run db:generate` (Run after modifying schema in `src/db/schema`)
+- **Apply migrations**: `bun run db:migrate`
+- **Open Database Studio**: `bun run db:studio`
+
+## Code Style & Conventions
+
+- **Linter**: Strictly follow Biome rules. Run `bun run lint:fix` to auto-fix issues.
+- **TypeScript**: Strict mode is enabled. No `any` types unless absolutely necessary.
+- **Architecture**:
+  - Modular structure in `src/modules/`.
+  - Each module should have `index.ts` (routes), `service.ts` (logic), `model.ts` (data).
+  - Shared utilities in `src/common/`.
+  - Database schema in `src/db/schema/`.
+- **Environment**: Use `src/common/config.ts` for env vars (Envalid). Do not use `process.env` directly.
+- **Imports**: Use explicit imports.
+
+## Testing Instructions
+
+- **Runner**: Use `bun test`.
+- **Location**: Tests are located in `src/tests/`.
+- **Convention**: Name test files `*.test.ts`.
+- **Requirement**: All new features must include unit/integration tests.
+- **Coverage**: Run `bun test --coverage` to check coverage.
+
+## PR Instructions
+
+- **Branches**: Target `develop` for features, `main` for releases.
+- **Checks**:
+  - Ensure `bun run lint` and `bun test` pass locally before requesting review.
+  - **CI/CD**: A GitHub Action workflow ("Lint") automatically runs `bun run lint` on every Push and PR to `main` and `develop`. This check must pass for merging.
+- **Title**: Follow conventional commits (e.g., `feat: add user module`, `fix: resolve login bug`).
+
+## Directory Structure
+
+- `src/common`: Shared configuration and utilities.
+- `src/db`: Database setup, migrations, and schemas.
+- `src/modules`: Business logic modules.
+- `src/tests`: Test files.
+- `src/main.ts`: Application entry point.
+