Skip to content

airmessage/airmessage-web

Repository files navigation

AirMessage for web

AirMessage running on Microsoft Edge

AirMessage lets people use iMessage on the devices they like. AirMessage for web brings iMessage to modern web browsers over a WebSocket proxy. Production builds are hosted on web.airmessage.org.

Other AirMessage repositories: Server | Android | Connect (community)

Getting started

To build AirMessage for web, you will need Node.js.

AirMessage for web uses React and TypeScript. If you're not familiar with these tools, they both have great introductory guides:

AirMessage for web uses a configuration file to associate with online services like Firebase and Sentry. The app will not build without a valid configuration, so to get started quickly, you can copy the src/secrets.default.ts file to src/secrets.ts to use a pre-configured Firebase project, or you may provide your own Firebase configuration file.

To launch a development server, run npm start. To build a production-optimized bundle, run npm run build.

Building and running for AirMessage Connect

In order to help developers get started quickly, we host a separate open-source version of AirMessage Connect at connect-open.airmessage.org. The default configuration is pre-configured to authenticate and connect to this server. Since this version of AirMessage Connect is hosted in a separate environment from official servers, you will have to be running a version of AirMessage Server that also connects to the same AirMessage Connect server.

We kindly ask that you do not use AirMessage's official Connect servers with any unofficial builds of AirMessage-compatible software.


Thank you for your interest in contributing to AirMessage! You're helping to shape the future of an open, secure messaging market. Should you have any questions, comments, or concerns, please shoot an email to hello@airmessage.org.