mcpField
I
ionic-shared

ionic-shared

github.com/erkamyamanDevelopment1647 installsUpdated 1w ago
Repository

About ionic-shared

A shared reference skill for Ionic Capacitor apps across Angular, React, and Vue. It centralizes native plugin, app content, configuration, storage, release, and security guidance for framework-specific skills.

Key features

  1. 01Capacitor configuration guidance
  2. 02Environment and API key handling
  3. 03Persistent storage recommendations
  4. 04Theming, ads, and purchases
  5. 05Notifications and localization
  6. 06Store release and testing guidance

Use cases

  1. 01Set up Capacitor platforms and configuration
  2. 02Choose safe storage and API key practices
  3. 03Add shared native features to an app
  4. 04Prepare an app for release and testing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/erkamyaman/ionic-capacitor-skills --skill ionic-shared

After installing, type/ionic-sharedin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
admob.md
app-store-notes.md
capacitor-config.md
environments-and-keys.md
localization-content.md
push-notifications.md
revenuecat.md
storage.md
testing-checklist.md
theming.md

Details

From the project README

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

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 against npm view <pkg> version if uncertain. Do not write specific version numbers into SKILL.md examples — 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 isTesting flags to the build mode, not a hardcoded true. Shipping initializeForTesting: true or isTesting: true to production can get an AdMob account banned.
  • ❌ NEVER use localStorage directly — use @capacitor/preferences.
  • ❌ NEVER use @ionic/storage — use @capacitor/preferences.
  • ❌ NEVER use cordova-plugin-* — use the Capacitor equivalent.
  • ❌ NEVER use ngx-admob-free or 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 sync after 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).

Comments

Markdown supported