quapp

Dev server and build tool for Quapp projects. Serves your app over LAN with a QR code for mobile testing, and packages production builds as .qpp files.

Quick Start

If you scaffolded with create-quapp, run the pre-configured scripts:

npm run dev      # Start dev server
npm run qbuild   # Build .qpp package

Installation

For existing Vite projects:

npm install -D quapp

Initialize configuration and scripts:

npx quapp init

Commands

quapp serve

Starts Vite dev server with LAN network access and QR code.

npx quapp serve

| Flag | Description | |------|-------------| | -p, --port <port> | Server port (default: 5173) | | --host <host> | Host to bind | | --open | Open in browser | | --no-qr | Disable QR code | | --https | Enable HTTPS |

quapp build

Builds for production and creates .qpp package.

npx quapp build

| Flag | Description | |------|-------------| | -o, --output <file> | Output filename (default: dist.qpp) | | --skip-prompts | Non-interactive mode | | --no-clean | Keep dist folder |

quapp init

Initialize Quapp in an existing Vite project.

npx quapp init

| Flag | Description | |------|-------------| | -y, --yes | Skip prompts | | -f, --force | Overwrite existing config | | --dry-run | Preview changes |

quapp login

Sign in to your Quapp developer account to enable publishing.

npx quapp login

| Flag | Description | |------|-------------| | --email <email> | Account email (skip interactive prompt) | | --password <pass> | Account password (skip interactive prompt) |

quapp logout

Sign out and remove stored credentials.

npx quapp logout

quapp whoami

Show the currently logged-in user information.

npx quapp whoami

quapp publish

Upload and publish a .qpp file to the Quapp Store.

npx quapp publish

| Flag | Description | |------|-------------| | --file <path> | Path to .qpp file (default: ./dist.qpp) | | -n, --notes <text> | Release notes for this version | | --visibility <vis> | Visibility: public, unlisted, or private (default: public) |

Configuration

quapp.config.json:

{
  "server": {
    "port": 5173,
    "qr": true,
    "openBrowser": false
  },
  "build": {
    "outputFile": "dist.qpp"
  }
}

Global Options

| Flag | Description | |------|-------------| | --json | JSON output for automation | | --verbose | Detailed logging | | -h, --help | Show help | | -v, --version | Show version |

Automation

For CI/CD or programmatic usage:

npx quapp build --skip-prompts --json

{
  "success": true,
  "outputFile": "dist.qpp",
  "outputPath": "/path/to/dist.qpp",
  "duration": 1234
}

Requirements

• Node.js 18+
• Vite project

Related

• create-quapp — Project scaffolding

License

MIT