Lemon Squeezy
Lemon Squeezy MRR, subscription counts, and daily revenue, ambient on your iPhone home screen so you never need to open the dashboard to check.
Your MRR, always within reach
Lemon Squeezy handles tax, fraud, and payments as your Merchant of Record, but its dashboard requires you to open a browser to see your numbers. The Revenue module sums active customer MRR across your entire store and pairs it with trailing 30-day revenue and 30-day sales count. That combination covers both recurring baseline and total cash inflow, including one-time purchases that do not appear in MRR.
Catch payment failures before they become churn
The Subscriptions module surfaces three counts. Active gives you paying headcount. Trialing is your forward-looking conversion pipeline. Past-due is the one to watch: Lemon Squeezy retries failed payments four times over two weeks before moving a subscription to unpaid, and seeing a non-zero count on your home screen puts that window in front of you while there is still time to act. Trialing count trending up means your funnel is working; flat is worth investigating.
A daily pulse without logging in
The Today module answers "did anything happen today?" with three 24-hour metrics: paid orders placed, revenue earned from those orders, and new subscriptions created, including trials. All nine metrics across the three modules support sparkline charts drawing on up to 30 days of stored history, so a single glance shows both the current value and the direction it has been moving.
How to get your Lemon Squeezy API key
Generate an API key in Lemon Squeezy:
- Sign in → top-right account menu → Settings → API.
- (Optional) Toggle Test mode in the top-right of the dashboard before creating the key if you want a test-mode key.
- Click + Create API key, label it "PulseKit".
- Copy the value (shown once) and paste it here.
Keys are valid for 1 year. The key is full-account-scope, but PulseKit only reads stores, orders, subscriptions, and customers. It never writes.
Security
How we protect your credentials
Your Lemon Squeezy API key is sealed on this device with AES-256-GCM before it ever leaves your iPhone. Only your device holds the unwrap secret, stored in the iOS Keychain. The PulseKit backend wraps that already-encrypted payload again with its STORAGE_SECRET and writes the double-envelope blob to Postgres, so the server never sees your plaintext key at rest. Each fetch request includes a one-time unwrap secret that decrypts the inner envelope only long enough to call Lemon Squeezy. The key is scoped to this device, can be revoked from PulseKit at any time, and is never written to logs.
What you can track
Pick the metrics you care about and pin them as widgets.
Revenue
MRR plus trailing 30-day revenue and sales for a store
- 41MRR
- 26Revenue (30d)
- 86Sales (30d)
Subscriptions
Active, past-due, and trialing subscription counts for a store
- 42Active Subscriptions
- 53Past-Due Subscriptions
- 52Trialing Subscriptions
Today
Last-24h sales, revenue, and new subscriptions for a store
- 93Sales (24h)
- 33Revenue (24h)
- 57New Subscriptions (24h)
Numbers shown are illustrative — your widgets show your live data.
Who uses this
- Indie founders
Running a SaaS on Lemon Squeezy means checking MRR and subscriber counts daily. PulseKit puts MRR, active subscriber count, and trialing pipeline directly on the home screen, replacing the habit of opening the dashboard to confirm the business is growing. Past-due count acts as a passive alarm for payment failures that need attention.
- Solo SaaS operators
When you run a subscription product solo, past-due payments are urgent. Lemon Squeezy retries failed renewals over a two-week window before a subscription lapses, and a non-zero past-due count on your home screen is the earliest signal to act, whether by reaching out to a customer or flagging a billing issue before it turns to confirmed churn.
- Digital product sellers
For stores built around one-time downloads or license keys, the Revenue and Today modules still give the full picture: 30-day revenue, 30-day sales count, last-24h orders, and last-24h revenue. The Subscriptions module will display zero for all three counts, which is the correct ambient signal confirming there is nothing recurring to track.
- Early-stage founders
In early growth, trialing subscriber count is one of the most-watched numbers. Watching trial volume alongside new subscriptions in the last 24 hours gives a real-time read on whether a recent launch, pricing change, or feature update is generating conversions, without pulling up a dashboard or running a manual report.
FAQs
What Lemon Squeezy metrics can I see on my iPhone with PulseKit?
PulseKit tracks nine metrics across three modules. The Revenue module shows MRR, trailing 30-day revenue, and 30-day sales count. The Subscriptions module shows active, past-due, and trialing subscriber counts. The Today module shows paid orders, revenue, and new subscriptions created in the last 24 hours. All nine metrics include sparkline charts with up to 30 days of history.
How is MRR calculated for my Lemon Squeezy store in PulseKit?
PulseKit calculates MRR by summing the mrr field on every customer record in your store via the Lemon Squeezy API and converting from cents to dollars. The value reflects Lemon Squeezy's own per-customer MRR tracking, so it corresponds to actual active subscription billing amounts rather than a plan-price estimate.
What does past-due mean for a Lemon Squeezy subscription?
A past-due subscription is one where a renewal payment has failed but the subscription has not yet expired. Lemon Squeezy retries the payment four times over roughly two weeks before moving the subscription to unpaid. A non-zero past-due count on your home screen is an early warning, visible while there is still time to recover the customer before the retry window closes.
Can I track multiple Lemon Squeezy stores with PulseKit?
Yes. Each PulseKit widget has a store picker, so you can configure separate widgets pointing at separate stores. Most Lemon Squeezy sellers operate a single store, in which case the picker shows one row. Sellers with multiple stores can run independent widgets side by side on the home screen, one per store.
How often does PulseKit refresh my Lemon Squeezy data?
PulseKit fetches Lemon Squeezy data on demand when iOS requests a widget refresh. The Revenue and Subscriptions modules are configured with a one-hour refresh window; the Today module also refreshes hourly. Actual timing is managed by iOS widget scheduling, which balances refresh frequency against battery and network conditions on your device.
Does PulseKit work if I only sell one-time digital products?
Yes. The Revenue module shows 30-day revenue and sales count from your store's order history, and the Today module shows last-24-hour paid orders and revenue. Both work identically for one-time purchases. The Subscriptions module will show zero for all three counts, which is the correct ambient signal for a store with no recurring subscriptions.
Add Lemon Squeezy widgets to your iPhone
Install PulseKit, paste your credentials, pick a widget.