heremyapp/docs llms.txt
View as Markdown

Plans and billing

Every account starts on the Free plan. Paid plans include more and never stop serving: usage over the included amounts is billed at Cloudflare's list price plus 10%. Prices are in US dollars.

Plans

Free Starter Pro Enterprise
Price / month $0 $5 $20 Contact us
Spaces (sites) 3 10 50 Custom
Storage 1 GB 10 GB 100 GB Custom
Requests / month 1M 10M 50M Custom
Storage reads / month 1M 10M 50M Custom
Storage writes / month 100K 1M 5M Custom
Largest installer 100 MiB 500 MiB 2 GiB Custom
Deploys / day 20 100 500 Custom
Over the included amounts Sites pause, uploads are refused (see below) Billed at overage prices Billed at overage prices Per contract

Compare and upgrade at https://app.heremyapp.com/billing. Machine-readable: GET https://api.heremyapp.com/v1/plans (no token needed). Enterprise limits are set per contract; the numbers /v1/plans returns for it ("custom_limits": true) are only defaults before a contract.

Usage over your plan

Meter Overage price Cloudflare list price
Requests $0.33 per million requests $0.3
Storage reads $0.396 per million reads $0.36
Storage writes $4.95 per million writes $4.5
Storage $0.0165 per GB-month $0.015
Data transfer Free Free

What each meter counts:

Meter Counted when
Requests Every request to your site, its public URL redirect and its download URLs, including 304 Not Modified
Storage reads A file is read from storage to answer a request (not for 304 or HEAD) and when an upload is verified
Storage writes A new file is stored by a deploy (files already stored by your account are not written again) and each installer upload or part
Storage Site files (each distinct file once per account) plus installers; the billing period's daily average is the GB-months

CPU time, database operations, API calls and data transfer are included in every plan. A GB is 1,000,000,000 bytes.

What happens at the limits

Plan Requests or reads over the included amount Storage or writes over the included amount
Free Sites and downloads pause (503 with Retry-After) until the 1st of next month (UTC), or until you upgrade Deploys and installer uploads fail with 402 quota_exceeded
Starter, Pro Keep serving; billed at the prices above Keep working; billed at the prices above
Enterprise Per contract Per contract

These limits apply on every plan and fail with 402 plan_limit: the number of spaces and the largest installer. Deploys per day are limited too (429 deploy_limit, resets at 00:00 UTC). Error details include upgrade_url.

To free storage, delete old deployments (DELETE /v1/deployments/ID), installer versions (DELETE /v1/artifacts/ID) or whole spaces (DELETE /v1/spaces/SLUG). Deleting is permanent; do it only when the user agrees.

Changing plans

  • Upgrading takes effect as soon as the payment is confirmed, usually within seconds.
  • After a downgrade, nothing is deleted: existing spaces, deployments and installers keep working. If the account has more spaces than the new plan allows, it cannot create new spaces until it is under the limit. Deleting a space frees its slot immediately. Larger installers already published stay online; new ones must fit the new plan.

Checking usage

curl -sS --fail-with-body "$API/usage" -H "$AUTH"

The response has the current period, usage, the plan's included amounts, overage.estimated_usd, whether the account is paused, and usage per space. Freshness differs by field:

Field Updated
usage.storage_bytes_now, usage.spaces, usage.deploys_today Live
usage.requests, usage.reads, usage.writes, spaces (per space) Hourly, per UTC day; a new deploy or visit may take up to an hour to appear
usage.storage_gb Daily average of this period (GB-months), from hourly snapshots

People can see the same numbers in the dashboard at https://app.heremyapp.com.

Billing

  • Payments are handled by Paddle, our merchant of record: Paddle charges the card, adds the sales tax or VAT that applies, and sends the receipts.
  • A paid plan renews monthly from the day you subscribe. Usage over the plan in a billing period is added to the renewal payment at the end of that period.
  • Switching between Starter and Pro takes effect immediately and is prorated.
  • Downgrading to Free cancels the subscription at the end of the paid period. If usage charges are pending then, they are charged at that time (amounts under $1 are waived).
  • Change the plan, the payment method or download invoices in the dashboard under Billing.
  • Refunds: see https://heremyapp.com/refunds. Enterprise (custom limits, invoicing): support@heremyapp.com.

For agents

  • Do not upgrade, subscribe or enter payment details for the user. If a request fails with 402, tell the user what limit was reached and give them details.upgrade_url.
  • Before a large upload on the Free plan, check GET /v1/usage so the upload does not fail halfway.