ionic-shared
Framework-agnostic Capacitor concerns shared by Ionic Angular, React, and Vue apps — AdMob, RevenueCat, push notifications, @capacitor/preferences storage, theme switching, localization content, and App/Play store submission notes. Referenced by ionic-angular, ionic-react, and ionic-vue.
How do I install this agent skill?
npx skills add https://github.com/erkamyaman/ionic-capacitor-skills --skill ionic-sharedIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides architectural guidelines and code snippets for Ionic/Capacitor mobile applications. It includes high-quality security advice regarding API key management, distinguishing correctly between client-side publishable keys and server-side secrets. All referenced libraries are standard, well-known ecosystem plugins.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Ionic Shared (Capacitor) Guidelines
Cross-framework guidance for Ionic Capacitor apps. The framework skills (ionic-angular, ionic-react, ionic-vue) link here for native plugin and content topics so the same code is not repeated three times.
When to consult these references
- Capacitor config / native platforms: capacitor-config.md
- Environments & API keys (env vars per framework, what's safe to ship): environments-and-keys.md
- Persistent storage (
@capacitor/preferences): storage.md - Theme switching (Light / Dark / System): theming.md
- AdMob banner ads: admob.md
- RevenueCat purchases / paywall logic: revenuecat.md
- Push notifications: push-notifications.md
- Translation strings (TR / EN): localization-content.md
- App Store / Play Store submission notes: app-store-notes.md
- Pre-release testing checklist: testing-checklist.md
Hard rules (apply to all frameworks)
- ✅ Use the latest stable versions of Ionic Framework, Capacitor, and the framework (Angular / React / Vue). When scaffolding a new project, do not pin to older majors — let
npm install <pkg>resolve the latest. Verify againstnpm view <pkg> versionif uncertain. Do not write specific version numbers intoSKILL.mdexamples — they go stale. - ✅ Read API keys and ad unit IDs from environment variables, never hardcoded in source. The mobile bundle is not a secret container — only publishable keys (RevenueCat SDK key, AdMob unit ID, Firebase web config, Sentry DSN) belong in the app. Secret keys (Stripe
sk_…, OpenAI / Anthropic, RevenueCat REST secret) MUST live behind a backend. See environments-and-keys.md. - ✅ Tie
isTestingflags to the build mode, not a hardcodedtrue. ShippinginitializeForTesting: trueorisTesting: trueto production can get an AdMob account banned. - ❌ NEVER use
localStoragedirectly — use@capacitor/preferences. - ❌ NEVER use
@ionic/storage— use@capacitor/preferences. - ❌ NEVER use
cordova-plugin-*— use the Capacitor equivalent. - ❌ NEVER use
ngx-admob-freeor other deprecated ad libraries — use@capacitor-community/admob. - ❌ NEVER call Capacitor plugin methods synchronously — always
await. - ✅ ALWAYS guard native-only code with
Capacitor.isNativePlatform(). - ✅ ALWAYS run
npx cap syncafter installing or updating any Capacitor plugin.
Required shared libraries
npm install \
@capacitor/app \
@capacitor/preferences \
@capacitor/push-notifications \
@capacitor/splash-screen \
@capacitor/status-bar \
@revenuecat/purchases-capacitor \
@capacitor-community/admob \
swiper
@capacitor/app is needed by ionic-deep-links (and any skill that listens to appUrlOpen / appStateChange), so it's part of the shared baseline.
These are installed in addition to the framework-specific i18n library (see each framework's SKILL.md).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/erkamyaman/ionic-capacitor-skills/ionic-shared">View ionic-shared on skillZs</a>