A concept document. This describes a product being built and tested, not a live operating system. It is written to explain the idea to potential café and business partners.

Summary

cup.report turns advertising into a gift. Instead of interrupting people, a local business buys a stranger a coffee. It starts with a free physical card: a person receives a cup.report card (often handed out by a café), downloads the app, ties the card to their account, and from then on watches a short ad to unlock a free espresso at a participating café. The business reaches an engaged local person wrapped in goodwill; the café gains a customer; the person gets a real coffee for a few seconds of attention. Businesses receive reports on what their spend did — which is where the name comes from: cup.report.

The idea

Advertising today is taken, not given. It interrupts, and people resent it. Meanwhile local businesses struggle to reach nearby people with real intent, and cafés want foot traffic. cup.report resolves all three at once with a single move: let a business buy a person a coffee in exchange for their attention. Attention becomes something freely and knowingly exchanged, the ad arrives as generosity rather than intrusion, and a real local café is where it all lands.

How it starts: the free card

cup.report begins with a physical card, and the card does three jobs at once:

• It acquires users. A free card with a free espresso on it is a compelling reason to download the app — it solves the hardest problem any app has, getting people to install it.
• It builds café relationships. cup.report gives cafés free cards to hand out to their own customers. The café gives its customers a free coffee (funded, over time, by advertisers — not by the café), which costs the café nothing and makes it look generous. The café becomes a willing distribution channel, and that relationship is the foundation the whole project grows from.
• It is a genuine gift. Nobody refuses a free coffee, so cafés happily hand cards out and customers happily take them.

From one free object, cup.report acquires both sides of the marketplace at once — users and cafés — which is how it gets past the cold-start problem every marketplace faces.

How it works — the loop

1. A person receives a free cup.report card.
2. They download the app and tie the card to their account.
3. To get a coffee, they watch a short ad (about five seconds) from a local business.
4. That unlocks a free espresso, redeemed in person at a participating café.

The three participants

• People pay with attention, not money, and get a real coffee.
• Advertisers (local businesses) pay to reach a nearby, high-intent person, with the goodwill of having bought them a coffee attached to their name.
• Cafés provide the espresso, are paid for it, and gain foot traffic and potential regulars — and are the channel through which cards reach people.
• cup.report runs the marketplace, handles all payments, and produces the reports.

What a café needs — almost nothing

A café will only participate if accepting a redemption takes seconds and needs no new equipment. So the design is deliberately minimal:

• The person redeems in the app, which shows a clear “valid — one free espresso” screen for this café.
• The barista glances at it and serves the espresso.
• The redemption is counted automatically in the app (tied to the café the person chose), so the café is paid correctly and the report is generated.

The café needs nothing but a willingness to glance at a phone screen — no hardware, no staff logins, no per-coffee processing. (A confirming code or QR scan can be added later if reuse ever becomes a problem, but it is not required to start.)

Payment processing

The key principle: neither the customer nor the café handles payment complexity — cup.report does, in the background.

• The customer pays nothing. There is no payment processing on the customer side at all. They pay only with attention.
• The advertiser pays cup.report, ideally in prepaid blocks (for example, buying 100 placements at once). This is where real payment processing happens — a business paying cup.report by card or transfer through a standard processor. Buying in blocks means one payment covers many placements, which keeps processing fees low and gives cup.report working capital.
• cup.report pays the café in batches (weekly or monthly) for the redemptions it served — number of espressos times the agreed rate. This is a simple business-to-business settlement, not per-coffee card processing, so small espresso amounts are not eaten by per-transaction fees. It relies on the redemption count being accurate.
• cup.report sits in the middle: advertiser money comes in, café settlements go out, and cup.report keeps the margin. It bears the payment relationships on both ends so neither the café nor the customer ever touches them.

The flow, in one line: advertiser → cup.report → café. The customer touches no money.

The economics

The model is designed so the value of the advertisement exceeds the cost of the coffee, leaving a margin.

• A café is paid a set amount per espresso served.
• An advertiser pays per placement, priced above the café's cost.
• cup.report keeps the difference.

Illustratively: if an espresso costs the platform $3.50 and a placement sells for $10, the gross margin is $6.50 before costs. These figures are the model to be validated with real businesses, not settled facts.

Honest note on bootstrapping: before advertisers are paying, the free espressos are an investment — cup.report (or the café) funds them to build the user base and café relationships that then attract the advertisers who fund it going forward. The early free-card phase is spending to grow; the model becomes self-funding once advertisers are paying.

Why it is called cup.report

Every redemption generates data: how many coffees, when, which ads performed, what foot traffic followed. Businesses receive reports — a clear picture of what their spend achieved and who it reached. Over time this is the durable value of the platform: cup.report is a coffee-commerce and analytics service for cafés and local advertisers, and the free-coffee loop is the engine that generates the data the reports are built from.

Identity

cup.report has no usernames, no passwords, and no email addresses.

• Accounts are secured with passkeys (WebAuthn) — on iOS, unlocked with Face ID or Touch ID. A person is a device and a key, nothing more.
• Each person ties their physical cup.report card to their account. The card identifies which account it belongs to; the passkey is what proves it is them.
• Because there are no passwords or emails, there is no traditional account recovery, and that is an accepted trade. The stakes are low — coffee credits — so if a person loses access, creating a fresh account is acceptable. Simplicity is chosen over recoverability on purpose.

The app — essentially an inbox

The app is deliberately minimal. It is, in essence, an inbox: a simple list of ads waiting to be opened, each of which becomes a coffee. There is no feed, no social layer, no profiles, no clutter. It does one thing cleanly.

The screens:

• The inbox (home). A list of available ads, each one a short message from a local business, each worth a free espresso. This is the whole of the app's main surface. Each item shows who it is from (the business) and that it is worth a free coffee.
• Watching an ad. Tapping an inbox item plays its short ad (about five seconds). Watching it earns the espresso.
• Your coffee. Once an ad is watched, the person has an espresso to redeem. This screen shows the valid-redemption view the barista glances at, and lets the person confirm the café.
• Setup (once). On first use: tie the physical card to the account and create a passkey. After that, setup never reappears.

The entire experience is: open the inbox, open an ad, get a coffee, redeem it at a café. Keeping the app to an inbox is the point — it is the smallest thing that runs the loop, and nothing more.

The first client is a native iOS app. Native (rather than web) is the right choice because it supports both passkeys and direct NFC card reading, and it delivers the open-an-ad-then-redeem loop cleanly on a phone.

Principles

• Attention is given, not taken. The ad is opt-in. Nothing is forced on anyone.
• The coffee is a genuine gift, not a bait-and-switch.
• Local-first. Real local businesses, real local cafés, real people in a place.
• Minimal data. Collect only what a redemption and a report require.

Where it starts

• First café: Coffee Bureau.
• First advertisers: local businesses.
• This is early — a concept being tested, starting small and local, one café and a few businesses at a time. The first task is not scale; it is proving the loop works and that businesses find the placement worth its price.

The vision

In time, cup.report grows into a broader coffee-commerce and reporting system for cafés and local advertisers — a way for local money, attention, and coffee to move in a circle that benefits everyone it touches. That is the direction, not the current reality. It starts with one free espresso.