create-yiougo 1.0.0

package/README.md

@@ -0,0 +1,120 @@
+# create-yiougo
+
+A Bun create script for generating full-stack applications with Elysia backend and Vue 3 frontend in a monorepo structure.
+
+## Usage
+
+Create a new project using Bun:
+
+```bash
+bun create yiougo my-app
+```
+
+Or if you're developing locally:
+
+```bash
+bun run index.js my-app
+```
+
+## What's Included
+
+### Frontend (Vite + Vue 3)
+- **Vite** - Next generation frontend tooling
+- **Vue 3** - Progressive JavaScript framework with Composition API
+- **Quasar** - Material Design component framework
+- **Vue Router** - Official routing solution
+- **Pinia** - State management
+- **Sass** - CSS preprocessor with embedded compiler
+- **TypeScript** - Type safety
+
+### Backend (Elysia in server/)
+- **Elysia** - Fast and ergonomic web framework for Bun
+- **MongoDB** - NoSQL database with Mongoose ODM
+- **Redis** - In-memory caching
+- **Swagger** - API documentation
+- **CORS** - Cross-origin resource sharing
+
+### Shared Code
+- **TypeScript Types** - Shared types between frontend and backend
+- **Utilities** - Common utilities and helpers
+
+## Project Structure
+
+```
+my-app/
+├── src/                  # Frontend source code
+│   ├── api/              # API client
+│   ├── pages/            # Vue pages
+│   ├── router/           # Vue Router
+│   ├── stores/           # Pinia stores
+│   └── styles/           # Global styles
+├── server/               # Backend source code
+│   ├── config/           # Database and Redis config
+│   ├── models/           # Mongoose models
+│   ├── routes/           # API routes
+│   └── services/         # Business logic
+├── shared/               # Shared code
+│   └── types/            # TypeScript types
+├── public/               # Static assets
+├── vite.config.ts        # Vite configuration
+├── tsconfig.json         # Frontend TypeScript config
+├── tsconfig.server.json  # Backend TypeScript config
+└── package.json          # Single package.json
+```
+
+## Features
+
+- 🚀 **Fast** - Built with Bun and Vite for lightning-fast development
+- 🎨 **Modern UI** - Quasar components with Material Design
+- 📦 **Monorepo** - Single repository with unified dependencies
+- 🔒 **Type-Safe** - TypeScript throughout with shared types
+- 🗄️ **Database Ready** - MongoDB with Redis caching
+- 📝 **API Docs** - Automatic Swagger documentation
+- 🎯 **Best Practices** - Clean architecture and separation of concerns
+
+## Requirements
+
+- Bun >= 1.0.0
+- MongoDB (local or remote)
+- Redis (local or remote)
+
+## Development
+
+After creating your project:
+
+1. Install dependencies:
+```bash
+cd my-app
+bun install
+```
+
+2. Configure environment variables:
+```bash
+cp .env.example .env
+```
+   Update `.env` with your MongoDB and Redis connection strings
+
+3. Start development servers:
+```bash
+# Frontend (default port 5173)
+bun run dev
+
+# Backend (in another terminal, default port 3000)
+bun run dev:server
+```
+
+## Build
+
+Build frontend for production:
+```bash
+bun run build
+```
+
+Preview production build:
+```bash
+bun run preview
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env bun
+import { existsSync, mkdirSync, readdirSync, statSync, copyFileSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import prompts from 'prompts';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function main() {
+  console.log('🚀 Creating Yiougo Full-Stack Project...\n');
+
+  const args = process.argv.slice(2);
+  let projectName = args[0];
+
+  if (!projectName) {
+    const response = await prompts({
+      type: 'text',
+      name: 'projectName',
+      message: 'Project name:',
+      initial: 'my-yiougo-app'
+    });
+    projectName = response.projectName;
+  }
+
+  if (!projectName) {
+    console.error('❌ Project name is required');
+    process.exit(1);
+  }
+
+  const projectPath = join(process.cwd(), projectName);
+
+  if (existsSync(projectPath)) {
+    console.error(`❌ Directory ${projectName} already exists`);
+    process.exit(1);
+  }
+
+  console.log(`📁 Creating project at ${projectPath}\n`);
+  mkdirSync(projectPath, { recursive: true });
+
+  const templatePath = join(__dirname, 'template');
+  copyDir(templatePath, projectPath);
+
+  const packageJsonPath = join(projectPath, 'package.json');
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+  packageJson.name = projectName;
+  writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+  console.log('\n✅ Project created successfully!\n');
+  console.log('📝 Next steps:\n');
+  console.log(`   cd ${projectName}`);
+  console.log('   bun install');
+  console.log('   cp .env.example .env');
+  console.log('\n🚀 Start development:\n');
+  console.log('   Frontend: bun run dev');
+  console.log('   Backend:  bun run dev:server');
+  console.log('\n📖 Check README.md for more information\n');
+}
+
+function copyDir(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  const entries = readdirSync(src);
+
+  for (const entry of entries) {
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+
+    if (statSync(srcPath).isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-yiougo",
+  "version": "1.0.0",
+  "description": "A modern full-stack application template built with Elysia, Vue 3, Quasar, and Bun",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "create-yiougo": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "template"
+  ],
+  "scripts": {
+    "test": "bun run index.js test-project"
+  },
+  "keywords": [
+    "bun",
+    "create",
+    "template",
+    "vue",
+    "elysia",
+    "quasar",
+    "typescript",
+    "full-stack",
+    "mongodb",
+    "redis"
+  ],
+  "author": "Yiougo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/create-yiougo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-username/create-yiougo/issues"
+  },
+  "homepage": "https://github.com/your-username/create-yiougo#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
+}

package/template/.env.example

@@ -0,0 +1,7 @@
+VITE_API_URL=http://localhost:3000
+
+# Server
+PORT=3000
+MONGODB_URI=mongodb://localhost:27017/yiougo
+REDIS_URL=redis://localhost:6379
+NODE_ENV=development

package/template/README.md

@@ -0,0 +1,122 @@
+# Yiougo Full-Stack Application
+
+A modern full-stack application with Elysia backend and Vue 3 frontend in a monorepo structure.
+
+## Tech Stack
+
+### Frontend
+- **Vite** - Next generation frontend tooling
+- **Vue 3** - Progressive JavaScript framework
+- **Quasar** - Vue component framework
+- **Vue Router** - Official router for Vue.js
+- **Pinia** - Vue store
+- **Sass** - CSS preprocessor
+
+### Backend (Server)
+- **Elysia** - Fast and ergonomic web framework for Bun
+- **MongoDB** - NoSQL database
+- **Redis** - In-memory data store for caching
+
+## Project Structure
+
+```
+.
+├── src/              # Frontend source code
+│   ├── api/          # API client
+│   ├── pages/        # Vue pages
+│   ├── router/       # Vue Router
+│   ├── stores/       # Pinia stores
+│   └── styles/       # Global styles
+├── server/           # Backend source code
+│   ├── config/       # Database and Redis config
+│   ├── models/       # Mongoose models
+│   ├── routes/       # API routes
+│   └── services/     # Business logic
+├── shared/           # Shared types and utilities
+│   └── types/        # TypeScript types
+├── public/           # Static assets
+├── vite.config.ts    # Vite configuration
+├── tsconfig.json     # Frontend TypeScript config
+└── tsconfig.server.json  # Backend TypeScript config
+```
+
+## Getting Started
+
+### Prerequisites
+- Bun >= 1.0.0
+- MongoDB running locally or connection string
+- Redis running locally or connection string
+
+### Installation
+
+```bash
+bun install
+```
+
+### Configuration
+
+Copy `.env.example` to `.env` and configure:
+
+```env
+VITE_API_URL=http://localhost:3000
+
+# Server
+PORT=3000
+MONGODB_URI=mongodb://localhost:27017/yiougo
+REDIS_URL=redis://localhost:6379
+NODE_ENV=development
+```
+
+### Development
+
+Start frontend development server:
+```bash
+bun run dev
+```
+
+Start backend server (in another terminal):
+```bash
+bun run dev:server
+```
+
+- Frontend: http://localhost:5173
+- Backend: http://localhost:3000
+- API Docs: http://localhost:3000/swagger
+
+### Build
+
+Build frontend for production:
+```bash
+bun run build
+```
+
+Preview production build:
+```bash
+bun run preview
+```
+
+## API Documentation
+
+The backend API is available at `http://localhost:3000/api`
+
+Example endpoints:
+- `GET /api/health` - Health check
+- `GET /api/users` - Get all users
+- `POST /api/users` - Create a user
+- `GET /api/users/:id` - Get user by ID
+- `PUT /api/users/:id` - Update user
+- `DELETE /api/users/:id` - Delete user
+
+## Features
+
+- 🚀 **Fast** - Built with Bun and Vite for lightning-fast development
+- 🎨 **Modern UI** - Quasar components with Material Design
+- 📦 **Monorepo** - Single repository for frontend and backend
+- 🔒 **Type-Safe** - TypeScript throughout with shared types
+- 🗄️ **Database Ready** - MongoDB with Redis caching
+- 📝 **API Docs** - Automatic Swagger documentation
+- 🎯 **Best Practices** - Clean architecture and separation of concerns
+
+## License
+
+MIT

package/template/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" type="image/svg+xml" href="/vite.svg">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Yiougo App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>