@yoms/create-monorepo 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 create-monorepo
+
+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,204 @@
+# create-monorepo
+
+[![npm version](https://badge.fury.io/js/create-monorepo.svg)](https://www.npmjs.com/package/create-monorepo)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool to scaffold monorepo projects from templates with type sharing between packages.
+
+## Features
+
+- 🚀 **Quick Setup** - Generate a fully-configured monorepo in minutes
+- 📦 **Type Sharing** - Share Zod schemas and types between backend and frontend
+- 🎯 **Best Practices** - Pre-configured with modern tooling and patterns
+- 🔧 **Flexible** - Choose only the features you need
+- 🐳 **Production Ready** - Includes Docker, logging, error handling
+
+## Installation
+
+You don't need to install anything! Just run:
+
+```bash
+# Using npx (recommended)
+npx create-monorepo my-project
+
+# Using pnpm
+pnpm create monorepo my-project
+
+# Using yarn
+yarn create monorepo my-project
+
+# Using bun
+bunx create-monorepo my-project
+```
+
+## Quick Start
+
+```bash
+# Create a new project
+npx create-monorepo my-project
+
+# Navigate to project
+cd my-project
+
+# Install dependencies
+pnpm install
+
+# Start development
+pnpm dev
+
+# Visit:
+# - Backend API: http://localhost:3001
+# - Frontend: http://localhost:3000
+```
+
+## What You Get
+
+### Backend Options
+
+- **Framework**: Hono (recommended) or TSOA
+- **Database**: PostgreSQL or MongoDB with Prisma
+- **Caching**: Redis with ready-to-use cache service
+- **Email**: SMTP with Nodemailer
+- **Docs**: Swagger/OpenAPI with Scalar UI
+- **Logging**: Winston with structured logging
+- **Validation**: Zod schemas
+- **Type Safety**: Full TypeScript with strict mode
+
+### Frontend
+
+- **Framework**: Next.js 15 with App Router
+- **UI**: shadcn/ui components (optional)
+- **Styling**: Tailwind CSS
+- **Type Safety**: Shared types from backend
+
+### Shared Package
+
+- **Zod Schemas**: Single source of truth for validation and types
+- **Common Types**: Result, ApiResponse, Pagination, etc.
+- **Type Sharing**: Import types directly in backend and frontend
+
+## Project Structure
+
+```
+my-project/
+├── packages/
+│   ├── api/                  # Backend API
+│   │   ├── src/
+│   │   │   ├── routes/       # API routes
+│   │   │   ├── middleware/   # Express/Hono middleware
+│   │   │   ├── services/     # Business logic
+│   │   │   ├── config/       # Configuration (env, logger, db)
+│   │   │   └── types/        # TypeScript types
+│   │   ├── prisma/           # Database schema
+│   │   └── Dockerfile        # Production container
+│   │
+│   ├── web/                  # Next.js frontend
+│   │   ├── app/              # App router pages
+│   │   ├── components/       # React components
+│   │   └── lib/              # Utilities and API client
+│   │
+│   └── shared/               # Shared types and schemas
+│       └── src/
+│           ├── schemas/      # Zod schemas
+│           └── types.ts      # Common types
+│
+├── pnpm-workspace.yaml       # Workspace configuration
+└── tsconfig.base.json        # Shared TypeScript config
+```
+
+## Templates
+
+### Hono Backend
+
+- **Runtime-agnostic**: Works on Node, Bun, Deno, Cloudflare Workers
+- **Best TypeScript inference**: Type-safe without code generation
+- **Lightweight**: 12KB bundle, ~4x faster than Express
+- **Modern API**: Chainable, intuitive routing
+- **Built-in middleware**: CORS, compression, JWT, etc.
+
+### Type Sharing Pattern
+
+```typescript
+// packages/shared/src/schemas/user.schema.ts
+export const UserSchema = z.object({
+  id: z.string(),
+  email: z.string().email(),
+  name: z.string(),
+});
+export type User = z.infer<typeof UserSchema>;
+
+// packages/api/src/routes/users.ts
+import { UserSchema } from '@my-project/shared';
+// Use for validation and type inference
+
+// packages/web/lib/api.ts
+import type { User } from '@my-project/shared';
+// Use for type-safe API calls
+```
+
+## Configuration
+
+All configuration is done via environment variables (12-factor app):
+
+```env
+# Server
+NODE_ENV=development
+PORT=3001
+LOG_LEVEL=info
+
+# Database (if selected)
+DATABASE_URL=postgresql://...
+
+# Redis (if selected)
+REDIS_URL=redis://localhost:6379
+
+# SMTP (if selected)
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USER=...
+SMTP_PASS=...
+```
+
+## Available Scripts
+
+```bash
+# Development
+pnpm dev              # Start all packages in dev mode
+pnpm --filter api dev # Start only backend
+
+# Building
+pnpm build            # Build all packages
+pnpm typecheck        # Type-check all packages
+
+# Database (if Prisma is selected)
+pnpm --filter api prisma:generate  # Generate Prisma client
+pnpm --filter api prisma:migrate   # Run migrations
+pnpm --filter api prisma:studio    # Open Prisma Studio
+
+# Code quality
+pnpm lint             # Lint all packages
+pnpm format           # Format with Prettier
+```
+
+## Requirements
+
+- Node.js >= 18
+- pnpm, npm, yarn, or bun
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a history of changes.
+
+## Support
+
+- 📖 [Documentation](https://github.com/yoms07/monorepo-template)
+- 🐛 [Issue Tracker](https://github.com/yoms07/monorepo-template/issues)
+- 💬 [Discussions](https://github.com/yoms07/monorepo-template/discussions)
+
+## License
+
+MIT © [yoms07](https://github.com/yoms07)