A Bun-native terminal UI for testing Firebase Cloud Messaging (FCM) push notifications. Manage projects, devices, and messages entirely from your terminal.

• Keyboard-driven TUI — navigate everything without leaving the terminal
• Multi-project support — manage multiple Firebase projects with independent service accounts
• Device registry — store named iOS and Android device tokens per project
• Multi-device selection — send to multiple devices simultaneously with space to toggle
• Message composer — configure notification title/body, data payload, and platform-specific options (APNs/Android)
• Send results — per-device success/failure feedback after each send

• Bun (v1.0 or higher)
• A Firebase service account JSON file with FCM permissions

git clone https://github.com/yourusername/lazypush.git
cd lazypush
bun install

bun run src/index.tsx

1. Press n to create a project — enter a name and path to your Firebase service account JSON
2. Press tab to switch to the Devices panel, then a to add a device (name, platform, FCM token)
3. Use space to select one or more devices
4. Press m to compose your message (title, body, data payload, platform options)
5. Press s to send — results appear per device

All data is stored under ~/.config/lazypush/:

~/.config/lazypush/
└── projects/
    └── [project-id]/
        ├── config.json    # Project name and service account path
        └── devices.json   # Device registry for this project

{
  "id": "project-uuid",
  "name": "My Firebase Project",
  "serviceAccountPath": "/path/to/service-account.json",
  "createdAt": "2025-01-01T00:00:00Z"
}

[
  {
    "id": "device-uuid",
    "name": "John's iPhone",
    "platform": "ios",
    "token": "fcm-token-here",
    "createdAt": "2025-01-01T00:00:00Z"
  }
]

src/
├── index.tsx                  # Entry point
├── App.tsx                    # Root component + keyboard routing
├── store.ts                   # Reactive state (Solid.js signals/store)
├── components/
│   ├── ProjectList.tsx
│   ├── DeviceList.tsx
│   ├── StatusBar.tsx
│   └── modals/
│       ├── ProjectModal.tsx
│       ├── DeviceModal.tsx
│       ├── MessageModal.tsx
│       └── ResultModal.tsx
└── lib/
    ├── types.ts               # Shared TypeScript types
    ├── config.ts              # Config read/write (disk I/O)
    ├── fcm.ts                 # Firebase Admin SDK calls
    └── config.test.ts         # Unit tests

bun run src/index.tsx   # Run the TUI
bun test                # Run unit tests

• Service account JSON files contain sensitive Firebase credentials — never commit them
• lazypush stores only the file path reference, not the credentials themselves
• Service account files are .gitignored by default
• All data is local — nothing is synced to any cloud service

"Invalid service account" / auth error Verify the JSON is a valid Firebase service account with Cloud Messaging permissions.

"Token not registered" The FCM token is expired or invalid — regenerate it from your mobile app.

Notification not received Check that the service account matches the Firebase project the app is registered under, and that the device has internet connectivity.

MIT