hiworld-vite

A powerful, interactive CLI for scaffolding modern Vue 3 & Express.js applications.
Get started with the latest technology stack in seconds.

📦 Installation

You can install the CLI globally:

npm install -g hiworld-vite

Or run it directly using npx (recommended):

npx hiworld-vite create my-app

✨ Features

hiworld-vite provides two robust templates to kickstart your full-stack development.

🟢 Frontend Template (Vite + Vue)

Built for performance and developer experience.

• Core: Vite 7.x + Vue 3.5+
• Routing: Optional Vue Router 4.x setup with example views.
• State Management: Optional Pinia 3.x store configuration.
• Styling: Optional Tailwind CSS 3.4 integration (auto-injects utility classes).
• Persistence: Optional Dexie.js (IndexedDB) integration for client-side storage.

🔵 Backend Template (Express.js)

Production-ready REST API boilerplate.

• Modern JS: Full ES Modules (import/export) support.
• Database: Optional MySQL (mysql2) with automatic schema migration.
• Caching: Optional Redis (ioredis) integration.
• Security: Optional JWT authentication & Bcrypt password hashing.
• Utilities: Axios, CORS, and Dotenv pre-configured.

🚀 Usage

Run the create command and follow the interactive prompts:

hiworld-vite create <project-name>

Interactive Workflow

1. Select Project Type:

   • Frontend (Vite + Vue)
   • Backend (Express.js)

2. Customize Features (based on selection):

   • Frontend: Add Router? Pinia? Tailwind? Dexie?
   • Backend: Add MySQL? Redis? JWT? Axios?

3. Package Manager:

   • Choose between pnpm, npm, or yarn.

4. Auto Install:

   • The CLI can automatically install dependencies for you.

📂 Backend Configuration (.env)

If you choose the Express.js template, a .env file is automatically generated with secure defaults for your local development:

PORT=3015

# If MySQL selected
DB_HOST=127.0.0.1
DB_USER=hiworld_vite
DB_PASSWORD=PXEBmxH3KAccDs6P
DB_NAME=hiworld_vite

# If Redis selected
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=secret_redis

# If JWT selected
JWT_SECRET=jwtsecret

License

MIT