Projects and tokens

A project groups the events from one app, server or script. Each project has its own tokens and events.

Create a project

Press New project, then name it after the app that sends events. You can rename it later.

Free includes 1 project. Pro includes 10. Only workspace owners and admins can create projects.

Rename or delete a project

Open the project page. Change the name in Project name. The new name shows in the inbox and on every push.

Delete project removes the project, its tokens and all its events. This cannot be undone.

Create a token

1. 1
   Open the project page and press Create token.
2. 2
   Name it after where it will run, like Production server.
3. 3
   Copy the token now. It is shown only once.

Tinyping stores only a hash of the token, so it cannot show it again. If you lose it, create a new one. A project can have up to 10 active tokens.

Copy the environment variable

The project page has a Copy env button. It copies TINYPING_TOKEN in dotenv format. The token also tells Tinyping which project the event belongs to.

TINYPING_TOKEN=your-token

Revoke a token

Press Revoke next to the token. Apps that use it stop sending events right away. You cannot undo this.

To rotate a token, create a new one, deploy it, then revoke the old one.

Token safety

• Keep tokens on your server or in CI secrets.
• Never put a token in a browser bundle or a mobile app.
• Never commit a token to git.
• Use one token per place, so you can revoke one without breaking the others.

Mute a project

Muting changes only the pushes to your own devices. Events still arrive in the inbox.

Open the project page and turn off Push notifications from this project. Turn it on again to get pushes.