Create your first project

You need a Firebase project with Cloud Messaging enabled. PushFire uses a Service Account JSON file to send push notifications on your behalf.

Sign in to the PushFire Console with Sign in with Google at /sign-in. After authentication you land on Your Projects (/projects).

How you start depends on whether you already have projects:

• First project — on the empty state, select Let's Get Started (routes to /projects/new).
• Additional project — open Your Projects and select the Create a PushFire project card, or choose New project from the sidebar project switcher.

[TODO: captura de la tarjeta Create a PushFire project en la lista de proyectos]

The creation page (Create a new project) is a single scrollable form with three step cards—not a multi-page wizard.

Step 1 — Project basics

• Name (required) — how the project appears across dashboards and menus.
• Description (optional) — a short note to help collaborators understand the goal.

Step 2 — Get Firebase credentials

This card is instructional only. In the Firebase Console, open Project settings → Service accounts → Generate new private key to download the JSON file.

Keep the file secure—never commit it to version control or share it publicly.

The form includes a collapsible See required fields and JSON example section listing the validated keys (including type = service_account).

[TODO: captura del paso Get Firebase credentials en el formulario de nuevo proyecto]

Step 3 — Upload credentials

Upload the JSON with the Service Account Key uploader (Choose JSON file). The file is validated before submission.

Once validated and saved, credentials are encrypted and are not displayed again. Select Start Project (shows Starting... while processing). On success you see a confirmation toast and are redirected to Getting Started inside the new project.

[TODO: captura del uploader de Service Account Key]

The Getting Started page shows a Your onboarding checklist with four recommended steps:

1. Connect your stack — plug in delivery providers (Resend for email today).
2. Build smart segments — create rule-based audience groups.
3. Verify your domain — authenticate your sender domain (Owner only).
4. Launch a campaign — create a workflow or broadcast under Messaging.

The same page also links to workspace essentials, developer integration (API Token, layouts), and platform documentation.

Open Settings → General (Owner and Editor only). Under Firebase Configuration, the Account Service Key section never displays existing credentials.

Select Update Credentials to reveal the JSON uploader, upload a replacement file, and click Update. The project_id in the new JSON must match the Firebase project already linked—otherwise the console rejects the upload.