tempo.Open my planner
Home

Detailed Tempo guide

A clearer day,
one box at a time.

Follow the steps below for everyday planning, focus sessions, administration, revenue reporting, and external API access.

Download the narrated training video

Start here

Create your account and first plan

  1. 1Select Get started and enter your name, email, and a unique password of 8–128 characters.
  2. 2Start with a 15-day free trial. Subscribe for $2.99/month through PayPal before it ends to keep planner access.
  3. 3After payment confirmation, open My day. Your account and schedule are saved for your next visit.
  4. 4Begin with just three boxes: one meaningful task, one routine task, and one real break.

Plan a time box

  1. 1.Open My day and select New time box (or + on mobile).
  2. 2.Write a specific action, such as “Draft the proposal outline.”
  3. 3.Choose the date, start time, duration, and a color.
  4. 4.Add optional notes or the first small step.
  5. 5.Select Add to my day. If an overlap appears, adjust the time or duration.

Focus and finish

  1. 1.Select the play icon on a box, or find it under Up next.
  2. 2.Review the title and notes, then select Start focus.
  3. 3.Pause and resume when needed; the circular arrow resets the timer.
  4. 4.Select the checkmark when finished, or close without changing the box.
  5. 5.Reopen a completed box from its circular-arrow icon if plans change.

Edit or reschedule

  1. 1.Select the box title in My day or Week.
  2. 2.Change the task, date, start, duration, color, or notes.
  3. 3.Select Save changes. Overlap checks still apply.
  4. 4.To delete, select the trash icon and confirm. This is permanent.

Review your rhythm

  1. 1.Use the day arrows to plan ahead or Back to today to return.
  2. 2.Open Week for Monday–Sunday; use + in a day to plan there.
  3. 3.Open Insights for current-week planned and completed time.
  4. 4.Use the charts as observations, not scores. A sustainable plan needs open space.

Administration

See users and verified revenue.

  1. 1.Set ADMIN_EMAILS to the administrator account’s email in your environment settings. Separate multiple emails with commas.
  2. 2.Restart Tempo, then create or sign in to that exact account and open Admin.
  3. 3.Use the overview for total users, active subscriptions, recorded revenue, and time boxes. Search the user table by name or email.
  4. 4.Revenue comes only from verified PayPal completed-sale or Stripe paid-invoice events. It is never estimated from sign-ups. Historical payments before webhook setup are not automatically backfilled.
  5. 5.Connect PAYMENT.SALE.COMPLETED in your PayPal webhook so new subscription payments appear automatically.
Open admin

External API

Pull data into another system.

  1. 1.In Admin → External API keys, enter a descriptive key name.
  2. 2.Choose only required read scopes: Users, Revenue, or Time blocks.
  3. 3.Create the key and copy it immediately. Tempo stores only its hash and cannot show it again.
  4. 4.Send the key as a Bearer token in the Authorization header over HTTPS.
  5. 5.Use page and limit for pagination; limit defaults to 50 and cannot exceed 100.
  6. 6.Revoke a key in Admin when the integration ends. Future requests immediately return 401.

GET /api/v1/users — accounts and subscription status

GET /api/v1/revenue — verified payments and totals

GET /api/v1/time-blocks — scheduled boxes; optional userId filter

curl "https://your-domain.example/api/v1/users?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Amounts are integer cents for USD and remain grouped by currency. See docs/API_REFERENCE.md in the project for complete response examples and error handling.