Ionic Everywhere

ionic-everywhere

@involvex/ionic-everywhere — a CLI that scaffolds one responsive Ionic React codebase that builds to Web + Android (Capacitor 8) + Desktop (@capawesome/capacitor-electron).

Binaries: ionic-everywhere and create-ionic-everywhere (same entry point).

Prerequisites

• Node.js >= 20
• bun (preferred) or npm
• JDK 21+ (for Android builds)
• Android SDK (for Android builds)

Creating a New Project

# Interactive scaffold
ionic-everywhere new my-app

# With defaults (no prompts)
ionic-everywhere new my-app --yes

# Web + Android only
ionic-everywhere new my-app --yes --no-electron

# Web + Desktop only
ionic-everywhere new my-app --yes --no-android

# With specific options
ionic-everywhere new my-app --name "My App" --app-id com.example.myapp --pm bun --layout drawer --styling tailwind --theme hacker

# Skip dependency install and platform setup
ionic-everywhere new my-app --yes --no-install

Options

Environment Checks

ionic-everywhere doctor

Checks Node.js, package manager, bun stability, git, JDK, and Android SDK.

Building and Running

# Web dev server
npm run dev

# Production web build
npm run build

# Build once + sync both shells
npm run sync

# Android (auto build+sync)
npm run android

# Android debug APK
npm run build:android

# Desktop app (auto build+sync)
npm run desktop

# Desktop dev (vite + electron, hot reload + DevTools)
npm run desktop:dev

# Desktop installer/portable
npm run build:desktop

Adding Platforms

# Add Android to existing project
ionic-everywhere add android

# Add Desktop (Electron) to existing project
ionic-everywhere add desktop

Installing Plugins

npm install @capacitor/camera
npx cap sync

Template Tokens

The template uses __APP_NAME__, __APP_ID__, and __APP_NAME_KEBAB__ tokens that are replaced during scaffolding.

Troubleshooting

• npx cap sync fails: Verify @capacitor/core and @capacitor/cli versions match. Run cd android && ./gradlew clean.
• Build fails after config changes: Clean with cd android && ./gradlew clean, then rebuild.
• Plugin not found at runtime: Run npx cap sync after plugin installation.
• JDK errors: Ensure JDK 21+ is installed and JAVA_HOME is set.
• Android SDK not found: Set ANDROID_HOME to your Android SDK path.

Agent Skills Setup

After scaffolding a new project with ionic-everywhere new, you will be prompted to set up .agents/skills/ for AI agent skills. This creates a .agents/skills/ directory in your project where you can install skills for AI coding agents.

To manually install the ionic-everywhere skill:

npx skills add https://github.com/involvex/ionic-everywhere.git

This installs the skill to .agents/skills/ionic-everywhere/ and creates symlinks for detected agents (Claude Code, Cursor, OpenCode, etc.).

Repository Structure

packages/ionic-everywhere/   The CLI (TypeScript -> dist/, bins in package.json)
  src/                       cli.ts (entry/dispatch), new.ts (scaffold flow),
                             scaffold.ts (copy+tokens), doctor.ts (env checks)
  templates/default/         The generated app template
reference-app/               Hand-verified playground app
tests/                       Vitest unit tests

Commands Reference

Related Skills

• capacitor-expert — Comprehensive Capacitor reference
• capacitor-app-creation — Create a new Capacitor app
• capacitor-app-development — General Capacitor development
• capawesome-cli — Capawesome CLI reference
• capawesome-cloud — Live updates, native builds, app store publishing