phos 1.0.0

package/.eslintignore

@@ -0,0 +1,3 @@
+src/templates
+dist
+node_modules

package/AGENTS.md

@@ -0,0 +1,172 @@
+# AGENTS Guidelines for This Repository
+
+## Project Name: Phos CLI
+
+Full-stack interactive project generator CLI that scaffolds modern web applications with configurable backends and frontends.
+
+**Version:** 1.0.0 (Production Release)
+
+### Core Features:
+
+1. **Interactive CLI** - Beautiful prompts using @clack/prompts
+2. **Multiple Backends** - Elysia (Bun), FastAPI (Python)
+3. **Multiple Frontends** - Astro, Svelte, Next.js
+4. **Monorepo Support** - Workspace configuration for scalable projects
+5. **Configurable Tooling** - TypeScript, ESLint, Prettier options
+6. **CSS Frameworks** - Tailwind, SCSS, CSS Modules
+7. **UI Components** - shadcn/ui, Radix UI
+8. **Testing Support** - Vitest, Playwright
+
+### Technology Stack:
+
+- **CLI**: Node.js + TypeScript
+- **CLI Framework**: Commander.js
+- **Interactive Prompts**: @clack/prompts
+- **File Operations**: fs-extra
+- **Template Engine**: Handlebars
+- **Terminal Colors**: picocolors
+- **Backend**: Elysia (Bun), FastAPI (Python)
+- **Frontend**: Astro, SvelteKit, Next.js
+- **Package Managers**: npm, yarn, pnpm, bun
+
+## 1. Development Workflow
+
+### CLI Tool (Phos)
+
+- Use Commander.js for CLI argument parsing
+- Use @clack/prompts for beautiful interactive UI
+- Use fs-extra for file system operations
+- Use Handlebars for template rendering
+- Use picocolors for terminal colors
+
+## 2. Architecture
+
+### Core Components
+
+```
+src/
+├── cli.ts                  # Main CLI entry point
+├── generators/
+│   ├── monorepo.ts         # Monorepo scaffold generator
+│   ├── single.ts           # Single project generator
+│   ├── backends/
+│   │   ├── elysia.ts       # Elysia (Bun) backend generator
+│   │   └── fastapi.ts      # FastAPI (Python) backend generator
+│   └── frontends/
+│       ├── astro.ts        # Astro frontend generator
+│       ├── svelte.ts       # Svelte frontend generator
+│       └── nextjs.ts       # Next.js frontend generator
+├── templates/              # Project templates
+└── utils/
+    └── helpers.ts          # Helper functions
+```
+
+### File Naming Conventions
+
+| Layer        | Pattern          | Example                 |
+| ------------ | ---------------- | ----------------------- |
+| CLI Commands | `*.ts`           | `cli.ts`, `monorepo.ts` |
+| Generators   | `{framework}.ts` | `elysia.ts`, `astro.ts` |
+| Utils        | `*.ts`           | `helpers.ts`            |
+
+**Rules:**
+
+- Use **PascalCase** for generator files
+- Use **camelCase** for utility functions
+- Export generators as named exports
+
+## 3. Keep Dependencies in Sync
+
+When adding/updating packages:
+
+```bash
+bun install <package>
+# OR
+npm install <package>
+```
+
+## 4. Coding Conventions
+
+### TypeScript
+
+- Use modern TypeScript with strict mode enabled
+- Import using `@/` alias for internal modules
+- Use ES modules with `.js` extensions
+
+### Project Templates
+
+- Use Handlebars for dynamic content
+- Include TypeScript/ESLint/Prettier options as needed
+- Generate complete project structures
+
+## 5. Key Technologies
+
+### CLI Framework
+
+- **Commander.js** - Command-line interface framework
+- **@clack/prompts** - Interactive prompts
+- **fs-extra** - Enhanced file system operations
+- **Handlebars** - Template engine
+- **picocolors** - Terminal colors
+
+### Supported Backends
+
+- **Elysia** - Fast and elegant Bun web framework
+- **FastAPI** - Modern Python web framework
+
+### Supported Frontends
+
+- **Astro** - Modern static site generator
+- **SvelteKit** - Full-stack Svelte framework
+- **Next.js** - React framework with server components
+
+## 6. Configuration Options
+
+### Backend Options
+
+- **TypeScript** - Enable/disable TypeScript
+- **ESLint** - Add ESLint configuration
+- **Prettier** - Add Prettier configuration
+
+### Frontend Options
+
+- **TypeScript** - Enable/disable TypeScript
+- **ESLint** - Add ESLint configuration
+- **Prettier** - Add Prettier configuration
+- **CSS Framework** - Tailwind, SCSS, CSS Modules
+- **UI Components** - shadcn/ui, Radix UI
+- **Testing** - Vitest, Playwright, or both
+
+## 7. Available Commands
+
+| Command                   | Purpose                        |
+| ------------------------- | ------------------------------ |
+| `bun run dev create`      | Run CLI in development mode    |
+| `bun run build`           | Build TypeScript to JavaScript |
+| `bun run start`           | Run built CLI                  |
+| `node dist/cli.js create` | Run CLI directly               |
+| `bun link`                | Link CLI globally              |
+| `phos create`             | Run CLI (after linking)        |
+
+## 8. Versioning
+
+Phos CLI follows semantic versioning:
+
+- **x.y.z (Patch/Bugfix)**: `0.0.x`, `1.0.x`, `2.0.x`
+  - Bug fixes
+  - Documentation updates
+  - Small improvements
+
+- **x.y.0 (Minor/Feature)**: `0.x.0`, `1.x.0`, `2.x.0`
+  - New features
+  - Breaking changes (when < 1.0.0)
+  - Significant updates
+
+- **x.0.0 (Major/Milestone)**: `1.0.0`, `2.0.0`, `3.0.0`
+  - Major architectural changes
+  - Complete rewrites
+  - Production-ready releases
+
+**Current Version: 1.0.0** - Production Release
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

package/CHANGELOG.md

@@ -0,0 +1,184 @@
+# Changelog
+
+All notable changes to Phos CLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [1.0.0] - 2026-02-09
+
+### Added
+
+- **Production Release**: Phos CLI is now production-ready with full feature support
+- **Interactive CLI**: Beautiful command-line interface powered by @clack/prompts
+- **Project Types**: Support for both Monorepo and Single repository structures
+- **Backend Frameworks**:
+  - Elysia - Fast and elegant Bun web framework with TypeScript support
+  - FastAPI - Modern Python web framework with type hints
+- **Frontend Frameworks**:
+  - Astro - Modern static site generator
+  - SvelteKit - Full-stack Svelte framework
+  - Next.js - React framework with server components and App Router
+- **Monorepo Features**:
+  - Organized workspace structure with `{ProjectName}_Backend` and `{ProjectName}_Frontend` folders
+  - `Docs/` folder with `Feature` and `DatabaseSetup` subfolders
+  - Root-level documentation: `AGENTS.md`, `LICENSE`, `env.example`
+  - Independent project configurations without workspace dependencies
+- **Single Project Mode**: Generate standalone backend or frontend projects
+- **Package Manager Support**:
+  - Node.js: npm, yarn, pnpm, bun
+  - Python: venv (virtual environment), pip (system)
+- **Configurable Tooling**:
+  - TypeScript support for backend (Elysia only) and frontend frameworks
+  - ESLint configuration with custom rules
+  - Prettier code formatting
+- **CSS Framework Options**: Tailwind CSS, SCSS, CSS Modules, or no framework
+- **UI Component Libraries**: shadcn/ui, Radix UI, or no components
+- **Testing Frameworks**: Vitest, Playwright, or both for unit and E2E testing
+- **Git Integration**: Optional Git repository initialization
+- **Dependency Installation**: Optional automatic dependency installation
+- **Template System**: Handlebars-based template engine with dynamic configuration
+- **Binary File Support**: Proper handling of images, fonts, and other binary files
+- **Helper Functions**:
+  - `eq` helper for equality checks in templates
+  - `or` helper for OR conditions in templates
+- **Configuration Summary**: Interactive summary display before project generation
+- **Project Validation**: Directory existence checks and project name validation
+- **Complete Documentation**: Auto-generated README.md, AGENTS.md, and schema docs
+
+### Fixed
+
+- **Binary File Handling**: Fixed `copyTemplate` function to properly handle binary files
+- **Template Processing**: Binary files (PNG, JPG, fonts, archives) are now copied directly without Handlebars processing
+- **Error Handling**: Improved error messages and cancellation handling throughout the CLI
+
+### Changed
+
+- **Monorepo Structure**: Updated from `apps/backend` and `apps/frontend` to capitalized `{ProjectName}_Backend` and `{ProjectName}_Frontend`
+- **Folder Naming**: Backend and frontend folder names now have capitalized first letters
+- **Default Configuration**: TypeScript, ESLint, and Prettier now default to `true`
+- **User Experience**: Users must manually deselect options they don't want instead of selecting them
+
+### Dependencies
+
+- @clack/prompts: ^1.0.0
+- commander: ^14.0.2
+- fs-extra: ^11.3.3
+- handlebars: ^4.7.8
+- picocolors: ^1.1.1
+- typescript: ^5.7.3
+- tsx: ^4.19.2 (dev)
+- @types/fs-extra: ^11.0.4 (dev)
+- @types/node: ^20.11.0 (dev)
+
+### Project Structure
+
+```
+phos/
+├── src/
+│   ├── cli.ts                  # Main CLI entry point
+│   ├── generators/
+│   │   ├── monorepo.ts         # Monorepo generator
+│   │   ├── single.ts           # Single project generator
+│   │   ├── backends/
+│   │   │   ├── elysia.ts       # Elysia backend generator
+│   │   │   └── fastapi.ts      # FastAPI backend generator
+│   │   └── frontends/
+│   │       ├── astro.ts        # Astro frontend generator
+│   │       ├── svelte.ts       # Svelte frontend generator
+│   │       └── nextjs.ts       # Next.js frontend generator
+│   ├── templates/              # Project templates
+│   │   ├── backend/
+│   │   │   ├── elysia/         # Elysia template files
+│   │   │   └── fastapi/        # FastAPI template files
+│   │   └── frontend/
+│   │       ├── astro/          # Astro template files
+│   │       ├── nextjs/         # Next.js template files
+│   │       └── svelte/         # Svelte template files
+│   └── utils/
+│       └── helpers.ts          # Helper functions
+├── package.json                 # Package configuration
+├── tsconfig.json               # TypeScript configuration
+├── .gitignore                 # Git ignore rules
+├── AGENTS.md                  # Project guidelines
+├── CHANGELOG.md               # Version history
+└── README.md                  # Documentation
+```
+
+## [0.3.0] - 2026-02-09
+
+### Changed
+
+- **Monorepo Structure Update**:
+  - Changed from `apps/backend` and `apps/frontend` to `{ProjectName}_Backend` and `{ProjectName}_Frontend`
+  - Added `Docs` folder with `Feature` and `DatabaseSetup` subfolders
+  - Added root level files: `AGENTS.md`, `LICENSE`, `env.example`
+  - Removed root `package.json` and workspace config files
+  - Each project now manages its own configurations independently
+- **Folder Naming**:
+  - Backend and frontend folder names now have capitalized first letter
+  - Example: `Colorful_Backend` and `Colorful_Frontend` instead of `colorful_Backend`
+- **Default Configuration**:
+  - TypeScript, ESLint, and Prettier now default to `true`
+  - Users must manually deselect options they don't want
+
+### Fixed
+
+- **Binary File Handling**:
+  - Fixed `copyTemplate` function to properly handle binary files
+  - Binary files (PNG, JPG, fonts, archives, etc.) are now copied directly
+  - No longer attempts to process binary files as Handlebars templates
+  - Fixes "IHDR" error when copying image files
+
+## [0.2.0] - 2025-02-09
+
+### Changed
+
+- **Template System Refactor**:
+  - All generators now use template files instead of dynamic generation
+  - Handlebars templating with conditional logic
+  - Dynamic configuration support (projectName, projectType, tooling options)
+  - Clean separation between generators and templates
+- **Template Structure**:
+  - Backend templates: Elysia, FastAPI with full project structures
+  - Frontend templates: Astro, Svelte, Next.js with proper configs
+  - All templates use Handlebars variables for customization
+- **Helper Functions**:
+  - `eq` helper for equality checks in templates
+  - `or` helper for OR conditions in templates
+  - `copyTemplate` function for template copying and rendering
+- **ESLint Configuration**:
+  - Added `.eslintignore` to exclude template folder
+  - Prevents false positives from Handlebars syntax in templates
+
+## [0.1.0] - 2025-02-09
+
+### Added
+
+- **Initial Release**: Complete project generator CLI
+  - Interactive prompts using @clack/prompts
+  - Multiple backend frameworks (Elysia, FastAPI)
+  - Multiple frontend frameworks (Astro, Svelte, Next.js)
+  - Monorepo and single project support
+  - Configurable tooling (TypeScript, ESLint, Prettier)
+  - CSS framework options (Tailwind, SCSS, CSS Modules)
+  - UI component library support (shadcn/ui, Radix UI)
+  - Testing framework options (Vitest, Playwright)
+  - Multiple package manager support (npm, yarn, pnpm, bun)
+- **Project Structure**:
+  - Well-organized codebase with generators, templates, and utilities
+  - TypeScript path aliases configured (@/\*)
+  - Comprehensive documentation (AGENTS.md, CHANGELOG.md, README.md)
+- **Configuration**:
+  - TypeScript strict mode enabled
+  - Module resolution set to bundler
+  - Path aliases for clean imports
+- **Dependencies Updated**:
+  - @clack/prompts: ^0.7.0 → ^1.0.0
+  - commander: ^12.0.0 → ^14.0.3
+  - fs-extra: ^11.2.0 → ^11.3.3
+  - handlebars: ^4.7.8 (unchanged)
+  - picocolors: ^1.0.0 → ^1.1.1
+  - tsx: ^4.7.0 → ^4.19.2
+  - typescript: ^5.3.0 → ^5.7.3
+  - @types/fs-extra: ^11.0.4 (unchanged)
+  - @types/node: ^20.11.0 (kept for Node 20 compatibility)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DotJumpDot
+
+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,279 @@
+<div align="center">
+
+  <h1>Phos ✨</h1>
+
+Full-stack interactive project generator CLI
+
+[![npm version](https://badge.fury.io/js/phos.svg)](https://www.npmjs.com/package/phos)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/phos)](https://nodejs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
+
+**Version 1.0.0 - Production Release** 🎉
+
+</div>
+
+---
+
+## About
+
+Phos is a powerful CLI tool that scaffolds modern full-stack web applications with configurable backends and frontends. Get started in seconds with interactive prompts and pre-configured templates.
+
+## Features
+
+- ✨ Interactive CLI with beautiful prompts
+- 🚀 Multiple backend frameworks (Elysia, FastAPI)
+- 🎨 Multiple frontend frameworks (Astro, Svelte, Next.js)
+- 📦 Monorepo support with workspace configuration
+- 🛠️ Configurable tooling (TypeScript, ESLint, Prettier)
+- 🎨 CSS framework options (Tailwind, SCSS, CSS Modules)
+- 🧩 UI component library support (shadcn/ui, Radix UI)
+- 🧪 Testing framework options (Vitest, Playwright)
+- 🔤 Multiple package manager support (npm, yarn, pnpm, bun)
+- 📝 Automatic README generation
+- 🌳 Git initialization
+- 🎯 Single project mode for standalone applications
+- 📚 Comprehensive documentation auto-generation
+
+## Quick Start
+
+```bash
+bun create phos
+```
+
+Follow the interactive prompts to configure your project, and Phos will generate a production-ready scaffold in seconds.
+
+## Installation
+
+### From NPM
+
+```bash
+bun create phos
+npm create phos
+yarn create phos
+```
+
+### Local Development
+
+```bash
+git clone <repository-url>
+cd phos
+bun install
+bun link
+phos create
+```
+
+## Usage
+
+```bash
+phos create
+```
+
+Phos will guide you through a series of questions to configure your project:
+
+1. **Project Name** - Name of your new project
+2. **Project Type** - Monorepo or Single repo
+3. **Backend Framework** - Elysia or FastAPI (Monorepo mode)
+4. **Backend Package Manager** - npm, yarn, pnpm, bun, venv, or pip
+5. **Backend: Use TypeScript?** - Enable TypeScript for backend
+6. **Backend: Add ESLint?** - Add ESLint configuration
+7. **Backend: Add Prettier?** - Add Prettier configuration
+8. **Frontend Framework** - Astro, Svelte, or Next.js
+9. **Frontend Package Manager** - npm, yarn, pnpm, or bun
+10. **Frontend: Use TypeScript?** - Enable TypeScript for frontend
+11. **Frontend: Add ESLint?** - Add ESLint configuration
+12. **Frontend: Add Prettier?** - Add Prettier configuration
+13. **Select CSS Framework** - No, Tailwind CSS, SCSS, or CSS Modules
+14. **Add UI Components?** - No, shadcn/ui, or Radix UI
+15. **Add Testing?** - No, Vitest, Playwright, or both
+16. **Initialize Git?** - Initialize a Git repository
+17. **Install Dependencies?** - Auto-install dependencies after generation
+
+## Project Types
+
+### Monorepo Mode
+
+Generates a full-stack monorepo with separate backend and frontend projects:
+
+```
+my-project/
+├── MyProject_Backend/    # Backend application
+├── MyProject_Frontend/   # Frontend application
+├── Docs/                 # Documentation folder
+│   ├── Feature/          # Feature documentation
+│   └── DatabaseSetup/    # Database setup scripts
+├── AGENTS.md             # Agent guidelines
+├── LICENSE               # License file
+├── env.example           # Environment variables template
+└── README.md             # Project README
+```
+
+### Single Project Mode
+
+Generates a standalone backend or frontend project:
+
+```
+my-project/
+├── src/                  # Source code
+├── public/               # Static assets (frontend)
+├── package.json          # Dependencies
+├── tsconfig.json         # TypeScript config
+└── README.md             # Project documentation
+```
+
+## Tech Stack
+
+### Core
+
+- **Runtime**: Node.js + TypeScript
+- **CLI Framework**: Commander.js
+- **Interactive Prompts**: @clack/prompts
+- **File Operations**: fs-extra
+- **Template Engine**: Handlebars
+- **Colors**: picocolors
+
+### Supported Frameworks
+
+#### Backend
+
+| Framework                                | Runtime | Description                        |
+| ---------------------------------------- | ------- | ---------------------------------- |
+| [Elysia](https://elysiajs.com/)          | Bun     | Fast and elegant Bun web framework |
+| [FastAPI](https://fastapi.tiangolo.com/) | Python  | Modern Python web framework        |
+
+#### Frontend
+
+| Framework                            | Description                            |
+| ------------------------------------ | -------------------------------------- |
+| [Astro](https://astro.build/)        | Modern static site generator           |
+| [SvelteKit](https://kit.svelte.dev/) | Full-stack Svelte framework            |
+| [Next.js](https://nextjs.org/)       | React framework with server components |
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev create
+
+# Build the project
+bun run build
+
+# Run the built CLI
+node dist/cli.js create
+```
+
+## Examples
+
+### Create a Monorepo with Elysia and Next.js
+
+```bash
+phos create
+# Project name: my-awesome-app
+# Project type: Monorepo
+# Backend Framework: Elysia
+# Backend package manager: bun
+# Backend: Use TypeScript? Yes
+# Backend: Add ESLint? Yes
+# Backend: Add Prettier? Yes
+# Frontend Framework: NextJS
+# Frontend package manager: bun
+# Frontend: Use TypeScript? Yes
+# Frontend: Add ESLint? Yes
+# Frontend: Add Prettier? Yes
+# CSS Framework: Tailwind CSS
+# UI Components: shadcn/ui
+# Testing: Vitest + Playwright
+# Initialize Git? Yes
+# Install dependencies? No
+```
+
+### Create a Single Astro Project
+
+```bash
+phos create
+# Project name: my-astro-site
+# Project type: Single repo
+# Framework: Astro
+# Package manager: bun
+# Use TypeScript? Yes
+# Add ESLint? Yes
+# Add Prettier? Yes
+# CSS Framework: Tailwind CSS
+# UI Components: No
+# Testing: Vitest
+# Initialize Git? Yes
+# Install dependencies? No
+```
+
+## Generated Projects Include
+
+### Backend (Elysia/FastAPI)
+
+- Pre-configured framework setup
+- Example API endpoints
+- Service layer architecture
+- Database connection setup
+- TypeScript/Python type definitions
+- ESLint/Pylint configuration
+- Prettier/Black configuration
+
+### Frontend (Astro/Svelte/Next.js)
+
+- Pre-configured framework setup
+- Example components and pages
+- Responsive layout
+- CSS framework integration
+- TypeScript configuration
+- ESLint configuration
+- Prettier configuration
+- Testing setup (Vitest/Playwright)
+
+### Documentation
+
+- Comprehensive README.md
+- AGENTS.md with project guidelines
+- Database schema documentation
+- Feature documentation templates
+- Environment variable templates
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Versioning
+
+Phos follows [semantic versioning](https://semver.org/).
+
+- **1.0.0** - Production release with full feature support
+- **1.0.x** - Patch releases (bug fixes, documentation)
+- **1.x.0** - Minor releases (new features, non-breaking changes)
+- **x.0.0** - Major releases (breaking changes)
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
+
+## Acknowledgments
+
+- [Clack](https://github.com/natemoo-re/clack) - Beautiful CLI prompts
+- [Commander.js](https://github.com/tj/commander.js) - CLI framework
+- [Picocolors](https://github.com/alexeyraspopov/picocolors) - Tiny color library
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<div align="center">
+
+Made with ❤️ by the DotJumpDot
+
+</div>