create-ely 0.1.1 → 0.1.3

package/src/utils.ts

@@ -0,0 +1,64 @@
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  statSync,
+} from 'node:fs';
+import { dirname, join } from 'node:path';
+
+/**
+ * Recursively copies files and directories from source to destination
+ * @param src - Source path to copy from
+ * @param dest - Destination path to copy to
+ * @param exclude - Array of file/directory names to exclude from copying
+ */
+export function copyRecursive(
+  src: string,
+  dest: string,
+  exclude: string[] = [],
+): void {
+  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);
+  }
+}
+
+/**
+ * Validates a project name according to npm package naming rules
+ * @param value - The project name to validate
+ * @returns Error message if invalid, undefined if valid
+ */
+export function validateProjectName(value: string): string | undefined {
+  if (!value || value.trim() === '') {
+    return 'Project name is required';
+  }
+
+  const trimmed = value.trim();
+  if (!/^[a-z0-9-]+$/.test(trimmed)) {
+    return 'Project name must contain only lowercase letters, numbers, and hyphens';
+  }
+
+  if (trimmed.startsWith('-') || trimmed.endsWith('-')) {
+    return 'Project name cannot start or end with a hyphen';
+  }
+
+  return undefined;
+}

package/templates/monorepo/README.md

@@ -1,75 +0,0 @@
-# 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

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

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

@@ -1,60 +0,0 @@
-# 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

@@ -1,19 +0,0 @@
-# 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

@@ -1,31 +0,0 @@
-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

@@ -1,36 +0,0 @@
-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

@@ -1,79 +0,0 @@
-# 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.
-

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

@@ -1,190 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.4.5] - 2026-01-03
-
-### Changed
-
-- Updated dependencies to the latest version
-
-## [0.4.4] - 2025-12-25
-
-### Added
-
-- Added `CLAUDE.md` with comprehensive development guidelines for AI-assisted development
-- Added `ENABLE_OPENAPI` environment variable to control OpenAPI documentation availability
-- Added new `src/middleware/error-handler.ts` for centralized error handling
-- Added startup logging to indicate OpenAPI documentation availability status
-
-### Changed
-
-- Extracted global error handler into separate middleware file (`src/middleware/error-handler.ts`)
-- Enhanced error logging in users module to log all caught errors before returning responses
-- Updated `src/common/logger.ts` to use raw `pino` instead of elysia-logger wrapper
-- Updated OpenAPI integration to respect `ENABLE_OPENAPI` configuration
-- Updated `.env.example` with `ENABLE_OPENAPI` setting and changed default `LOG_LEVEL` to `debug`
-- Updated dependencies: `@elysiajs/openapi` to ^1.4.12, `drizzle-orm` to ^0.45.1, `elysia` to ^1.4.19
-- Cleaned up `src/main.ts` by moving error handling logic to dedicated middleware
-
-### Removed
-
-- Removed `@bogeychan/elysia-logger` dependency in favor of raw Pino integration
-
-## [0.4.3] - 2025-12-15
-
-### Changed
-
-- Improved `README.md` with up-to-date docs
-- Fixed database variable value in `.env.example` to work with `docker-compose.yml` deployment out of the box
-- Updated Elysia to the latest `1.4.19` version
-
-## [0.4.2] - 2025-12-06
-
-### Added
-
-- Added database migration error handling
-- Added automatic database migrations on server startup
-
-### Changed
-
-- Updated dependencies to the latest version
-- Changed the way server starts to be more robust
-
-## [0.4.1] - 2025-12-03
-
-### Changed
-
-- Updated dependencies to the latest version
-- Updated error handling to be more robust
-- Updated ci workflows to use action environment variables instead of test environment
-
-### Fixed
-
-- Fixed error logging to not expose sensitive request information
-
-## [0.3.1] - 2025-12-01
-
-### Changed
-
-- Updated graceful shutdown functionality to be more robust
-- Updated dependencies to the latest version
-
-### Added
-
-- Added `@types/pg` to dev dependencies for type safety
-
-## [0.3.0] - 2025-11-27
-
-### Changed
-
-- Updated logger integration to use plugin-based approach at root app level
-- Improved app initialization and launch process with proper signal handling (SIGINT/SIGTERM)
-- Enhanced error logging with structured HTTP request context
-- Improved error handling in the users module
-
-## [0.2.4] - 2025-11-20
-
-### Fixed
-
-- Fixed `README.md` to use correct workflow name
-
-## [0.2.2] - 2025-11-20
-
-### Fixed
-
-- Fixed workflows to use environment variables
-
-## [0.2.0] - 2025-11-20
-
-### Added
-
-- Added local MCP server configuration
-- Added CI lint workflow
-- Added Biome-based formatting/linting
-- Added VS Code recommendations/settings included
-- Added project guidelines and updated changelog
-
-### Fixed
-
-- Improved user-creation error handling with clearer 422 responses and more robust failure checks
-
-### Changed
-
-- Updated dependencies to the latest version
-- Updated tests for consistent formatting and interaction patterns
-
-## [0.1.6] - 2025-11-11
-
-### Changed
-
-- Dependencies updated to the latest version
-- Fixed the way we define models
-- Moved database-related files to `src/db`
-- Moved common files to `src/common`
-- Removed aliases from `tsconfig.json` as it may interfere with monorepo setups
-
-### Added
-
-- Added `timestamp` prefix to migrations
-
-## [0.1.5] - 2025-09-30
-
-### Changed
-
-- Updated dependencies to the latest version
-- Updated the way we use logger
-- Improved `openapi` documentation
-
-## [0.1.4] - 2025-09-16
-
-### Changed
-
-- Updated packages to the latest version
-- Improved `Dockerfile`
-
-## [0.1.2] - 2025-09-14
-
-### Added
-
-- Added test directory to `bunfig.toml`
-- Added users test file
-
-### Fixed
-
-- Fixed `LOG_LEVEL` type in `config.ts`
-- Fixed mistaken comment in `users/index.ts`
-
-### Changed
-
-- Updated `README.md` with testing information and some badges
-
-## [0.1.1] - 2025-09-14
-
-### Changed
-
-- Removed invalid parameters from `bunfig.toml` and disabled telemetry
-
-## [0.1.0] - 2025-09-14
-
-### Added
-
-- Elysia web framework with TypeScript and Bun runtime
-- PostgreSQL database with Drizzle ORM
-- User management API endpoints
-- OpenAPI documentation generation
-- Docker and Docker Compose configuration
-- Database migration system
-- Pino logger with development pretty printing
-- Environment variable validation with Envalid
-- Hot reload development server
-- Initial users table schema
-
-### Changed
-
-- Updated OpenAPI documentation URLs from `/swagger` to `/openapi`