npm package: @supertiny99/easy-create
Description: A universal CLI tool to create projects using official framework scaffolding
Author: supertiny99
Latest version: 1.0.3

# easy-create

A universal CLI tool to create projects using official framework scaffolding.

> **Note**: This project uses [pnpm](https://pnpm.io/) as the package manager. Created projects will also use pnpm by default.

## Features

- Interactive project type selection
- Support for 9+ popular frameworks
- Uses pnpm for faster, more efficient installs
- Simple, clean CLI interface

## Supported Frameworks

| Framework | Description |
|-----------|-------------|
| Vue | Vue 3 project (official scaffold) |
| React | React + Vite project |
| Flutter | Flutter mobile/desktop app |
| WXT | Web browser extension framework |
| Next.js | Next.js React framework |
| Express | Express backend framework |
| React Native | React native mobile apps |
| UniApp | UniApp cross-platform framework |
| Tauri | Tauri desktop applications |

## Installation

```bash
# Using pnpm (recommended)
pnpm dlx @supertiny99/easy-create

# Using npx
npx @supertiny99/easy-create

# Global installation
pnpm add -g @supertiny99/easy-create
easy-create
```

## Usage

### Interactive Mode

```bash
easy-create
```

Follow the prompts to select a template and enter your project name.

### Direct Mode

```bash
easy-create <template> <project-name>
```

Example:
```bash
easy-create vue my-vue-app
easy-create react my-react-app
easy-create next my-next-app
```

### List Templates

```bash
easy-create list
```

## Examples

Create a Vue project:
```bash
pnpm dlx @supertiny99/easy-create vue my-vue-app
```

Create a React project:
```bash
pnpm dlx @supertiny99/easy-create react my-react-app
```

Create a Next.js project:
```bash
pnpm dlx @supertiny99/easy-create next my-next-app
```

## Development

```bash
# Install dependencies
pnpm install

# Build
pnpm run build

# Run locally
pnpm run dev

# Link for global testing
pnpm link -g
easy-create
```

## Publishing

This project uses GitHub Actions to automatically publish to npm when a version tag is pushed.

### Setup (First Time)

1. **Create npm token** with Automation permissions:
   - Visit https://www.npmjs.com/settings/tokens
   - Click "Generate New Token" → "Granular Access Token"
   - Set token name (e.g., `github-actions`)
   - Select `@supertiny99` scope
   - **Check "Automation"** (bypasses 2FA for CI/CD)
   - Copy the generated token

2. **Add token to GitHub Secrets**:
   - Visit https://github.com/supertiny99/easy-create/settings/secrets/actions
   - Click "New repository secret"
   - Name: `NPM_TOKEN`
   - Secret: paste the npm token
   - Click "Add secret"

### Release Process

To publish a new version:

```bash
# Bump version and create git tag
npm version patch  # or minor, major

# Push commits and tags
git push origin main
git push origin v1.0.3  # replace with actual version
```

GitHub Actions will automatically:
1. Build the project
2. Publish to npm
3. Make the package available as `@supertiny99/easy-create`

### Verification

After publishing, verify with:

```bash
npm view @supertiny99/easy-create
```

Or install globally:

```bash
pnpm add -g @supertiny99/easy-create
easy-create list
```

## License

MIT