Add Android Share Intent Handler for sharing links to Planka #880

Open
opened 2026-02-04 21:32:36 +03:00 by OVERLORD · 0 comments
Owner

Originally created by @micahstubbs on GitHub (Dec 12, 2025).

Summary

Implement an Android Share Intent Handler for Planka that allows users to share links directly to a Planka board/list from any Android app (browser, email, etc.) without opening the full Planka app UI.

Target Platform

  • Android (Samsung S22 primary target)
  • PWA Web Share Target API (for installed PWA)

Features

Android App

  1. Share Intent Receiver - Register to receive shared URLs/text from other apps
  2. User Configuration - Settings to configure:
    • Target Planka server (hard-coded: planka.eposto.org)
    • Default project, board, and list for new cards
    • Remember last used configuration
  3. Ephemeral Confirmation - Show a brief toast/snackbar confirmation when card is created (e.g., "Card created in [Board] > [List]") without launching full app UI
  4. Background Processing - Share action completes quickly without disrupting user workflow

PWA Enhancement

  1. Web Share Target - Add share_target to manifest.json so installed PWA can receive shared content
  2. Share Handler Page - Handle incoming shared data and create cards

Technical Requirements

  • Hard-coded server: planka.eposto.org
  • API authentication via stored credentials
  • Minimal UI footprint during share action
  • Settings accessible via app settings menu
  • Store last configured project/board/list in SharedPreferences

User Flow

  1. User shares link from browser
  2. Selects "Planka" from share sheet
  3. Brief toast appears: "Card created in [Board] > [List]"
  4. User continues in original app (no Planka UI opened)
  5. Card is created with shared URL as description/attachment

Out of Scope

  • Full card editing during share (use web UI for that)
  • Multiple server support (single hard-coded domain)

Implementation Tasks

  • Create Android app with share intent filter
  • Implement Planka API client for card creation
  • Build settings UI for project/board/list selection
  • Add ephemeral confirmation UI (toast/overlay)
  • Add PWA share_target to manifest.json
  • Create share handler page in web client
  • Build APK and test on Samsung S22
Originally created by @micahstubbs on GitHub (Dec 12, 2025). ## Summary Implement an Android Share Intent Handler for Planka that allows users to share links directly to a Planka board/list from any Android app (browser, email, etc.) without opening the full Planka app UI. ## Target Platform - Android (Samsung S22 primary target) - PWA Web Share Target API (for installed PWA) ## Features ### Android App 1. **Share Intent Receiver** - Register to receive shared URLs/text from other apps 2. **User Configuration** - Settings to configure: - Target Planka server (hard-coded: planka.eposto.org) - Default project, board, and list for new cards - Remember last used configuration 3. **Ephemeral Confirmation** - Show a brief toast/snackbar confirmation when card is created (e.g., "Card created in [Board] > [List]") without launching full app UI 4. **Background Processing** - Share action completes quickly without disrupting user workflow ### PWA Enhancement 1. **Web Share Target** - Add share_target to manifest.json so installed PWA can receive shared content 2. **Share Handler Page** - Handle incoming shared data and create cards ## Technical Requirements - Hard-coded server: `planka.eposto.org` - API authentication via stored credentials - Minimal UI footprint during share action - Settings accessible via app settings menu - Store last configured project/board/list in SharedPreferences ## User Flow 1. User shares link from browser 2. Selects "Planka" from share sheet 3. Brief toast appears: "Card created in [Board] > [List]" 4. User continues in original app (no Planka UI opened) 5. Card is created with shared URL as description/attachment ## Out of Scope - Full card editing during share (use web UI for that) - Multiple server support (single hard-coded domain) ## Implementation Tasks - [ ] Create Android app with share intent filter - [ ] Implement Planka API client for card creation - [ ] Build settings UI for project/board/list selection - [ ] Add ephemeral confirmation UI (toast/overlay) - [ ] Add PWA share_target to manifest.json - [ ] Create share handler page in web client - [ ] Build APK and test on Samsung S22
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/planka#880