fcmtester

Overview

FCM Tester helps developers validate notification delivery, configure payload structures, and test various notification types without requiring a complete app deployment. Key Features that not available in other FCM Tester tools:

• Supports Data Only Messages
• FCM request payload and response payload are clearly visible

Live site

https://fcmtester.com

Screenshot

FCM Tester interface showing the notification configuration panel and response history.

Features

• Multiple Notification Types: Send both visual notifications and silent data-only messages
• Custom Payload Support: Define custom JSON data payloads for your notifications
• Token Management: Save and manage multiple device tokens for testing
• iOS APNS Support: Configure Bundle IDs for Apple Push Notification Service
• Response History: View detailed logs of previous notification attempts
• Dark Mode Support: Toggle between light and dark themes
• Secure Credential Handling: Firebase private keys are processed only for the active request and never stored
• Docker Support: Easy deployment with Docker

Getting Started

Hosted Version

The easiest way to use FCM Tester is through our hosted version at https://fcmtester.com - no installation required.

Prerequisites

• Docker (for containerized deployment)
• OR:
  • .NET 9.0 SDK (for backend)
  • Node.js and npm (for frontend)

Installation

Using Pre-built Docker Image

The easiest way to get started is using our pre-built Docker image:

# Pull the image from DockerHub
docker pull gobansource/fcmtester:latest

# Run the container
docker run -p 8080:8080 gobansource/fcmtester:latest

# Access FCM Tester at http://localhost:8080

Building Docker Image Locally

# Clone the repository
git clone https://github.com/gobansource/fcmtester.git
cd fcmtester

# Build the frontend
cd frontend
npm install
npm run build

# Build and run with Docker
docker build -t fcmtester .
docker run -p 8080:8080 fcmtester

Manual Setup

# Backend setup
cd backend
dotnet restore
dotnet run

# Frontend setup (in another terminal)
cd frontend
npm install
npm run dev

Usage

1. Upload Firebase Private Key: Select your Firebase service account private key (JSON format)
2. Add Device Tokens: Enter registration tokens from your test devices
3. Configure Notification:
   • For visual notifications: Add a title and message
   • For data-only messages: Define a JSON data payload
   • For iOS: Configure the Bundle ID
4. Send and Monitor: Send the notification and view the detailed response

Development

The application consists of:

• Frontend: React with TypeScript, Vite, and Tailwind CSS
• Backend: ASP.NET Core 9.0 with Firebase Admin SDK

Security Considerations

• Firebase private keys are processed only for the duration of a request and not persisted
• Device tokens are stored in browser local storage for convenience but never transmitted to servers
• No analytics or tracking is implemented in the application

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

License

This project is licensed under the terms of the MIT license. See the LICENSE file for details.