Capacitor Implementation for Android Application

[mroxso]

User Story

As a user, I want to access our Next.js application as a native Android app (via Capacitor), so that I can install it on my device and use it with native capabilities (like splash screen, status bar, push notifications in future).

---

Acceptance Criteria

• Capacitor is integrated into the existing Next.js client-side application.
• The app can be built and packaged as a native Android app (APK or AAB).
• Running npx cap run android launches the Next.js app inside a WebView.
• Android project structure (android/) is properly generated and included in version control.
• App opens the deployed/statically exported Next.js site (or local build).
• Basic app metadata (app name, package ID, version) is configured.
• Documented steps for building and running the app locally.

---

Technical Notes

• Use Capacitor 6+.

• Add @capacitor/core and @capacitor/cli to the project.

• Run npx cap init with project details.

• Configure capacitor.config.ts to point to .next build or exported static output.

• Add Android platform: npx cap add android.

• Sync assets: npx cap sync android.

• Build flow:

  • next build && next export (if static export is viable)
  • Or point to deployed URL if server-side rendering is required.

• Verify Android app runs in emulator/physical device.

---

Out of Scope

• iOS support (to be handled in a future ticket).