jac-mobile-app

Package Jac client applications as native Android and iOS apps using Capacitor.

Updated Jul 26, 2026
One-click install
npx skills add https://github.com/nihalnihalani/jachacks-sf-2026 --skill jac-mobile-app-nihalnihalani
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jac-mobile-app
Source: https://github.com/nihalnihalani/jachacks-sf-2026/tree/main/plugins/jac-codex/skills/jac-mobile-app
Command: npx skills add https://github.com/nihalnihalani/jachacks-sf-2026 --skill jac-mobile-app-nihalnihalani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a Jac web client into a shippable native mobile app normally requires manually wiring Capacitor, configuring signing, and managing device debugging. This Skill guides the full workflow of scaffolding, configuring, developing, and building Android APKs/AABs and iOS apps from an existing Jac client codebase. ## Core Features & Use Cases - One-time scaffolding: Run jac setup mobile to install Capacitor dependencies, generate capacitor.config.json, and create android/ and ios/ native projects. - Dev loop with live reload: Use jac start main.jac --client mobile --dev for on-device hot reload, with automatic host detection and adb reverse port forwarding on Android. - Production builds: Run jac build --client mobile to produce debug or release APKs, AAB bundles, or iOS builds via xcodebuild, controlled by [client.mobile] settings in jac.toml. - Use Case: You have a Jac web app and want it on the Google Play Store. Scaffold the Android target, set app_id and release = true in jac.toml, build the AAB, and configure signing in android/app/build.gradle. ## Quick Start Set up and run my Jac app as a native Android app on my connected device using jac setup mobile and the dev client command.

Frequently Asked Questions about jac-mobile-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Jac web app as a native Android app?▼

Run `jac setup mobile --platform android` to scaffold the Capacitor project, then `jac build --client mobile --platform android` to produce an APK at android/app/build/outputs/apk. Set release = true in [client.mobile] for a release build, or bundle = true for an AAB.

How do I run a Jac mobile app with live reload on a device?▼

Use `jac start main.jac --client mobile --dev` to run cap sync and cap run with live reload. On Android, jac-client automatically attempts adb reverse for the Vite and API ports, so manual port forwarding is usually unnecessary.

Does the Jac mobile app include a backend server?▼

No, the mobile app is frontend only. The native shell is a webview running your client bundle, and every walker or def:pub call goes over HTTP to a Jac server you deploy separately, so plan the backend deployment before shipping.

Can I build an iOS app from a Jac project on Linux or Windows?▼

No, iOS builds require macOS with Xcode, Command Line Tools, and CocoaPods installed. Android builds work on other platforms with Java/JDK 21+ and the Android SDK via Android Studio.

Why does my Jac mobile app show a blank screen on device?▼

A blank screen usually means the webview cannot reach the dev server. Check the printed host and port, confirm `adb devices` shows the target as authorized, and fall back to manual `adb reverse tcp:5173 tcp:5173` and `tcp:8000 tcp:8000`.

How do I add native features like camera or push notifications to a Jac mobile app?▼

Install Capacitor plugins with `jac install --npm @capacitor/camera` (or the relevant plugin), then run `npx cap sync` to re-sync the native projects. You must re-sync after any plugin change for it to take effect.