htmlsharechecking
/ uses · utilities · the awkward bill, handled

split it the way you actually split it.

every tip calculator does the easy case: one total, one percentage, divided evenly. that case does not need a calculator.

the case that does is the one at the end of a real meal — someone did not drink, two people shared a starter, one person is paying for their parents, and the service charge is already on the bill.

a page built for how your group splits things does that, and it takes one message to make.

what you make
a splitter that handles the awkward case
what it stores
nothing at all
how long it takes
one message

arithmetic for the end of a meal.

01 / what it is

the design decision that matters is which case is the default. most calculators put the even split first and hide the rest; a real bill is usually uneven, so this one starts from people and items and treats the even split as the easy fallback.

it stores nothing, needs no account, and is on one screen. it is also a two-minute build, which makes it a good first thing to ask an assistant for if you have not done this before.

  • the total, the tip, and the split
  • items assigned to individuals where they should be
  • people who are exempt from part of it
  • rounding that leaves nobody owing 6.83
  • the per-person amount, large enough to read across a table
what it does
total, tip, exclusions, per-item assignment, per-person amounts
what it stores
nothing. close the tab and it is gone
currency
whichever you asked for, formatted consistently
rounding
to whatever you specified, with the remainder handled explicitly

see one in action.

02 / example
htmlshare.net/p/…
screen capture · silent loop
video coming soon

a bill split six ways with two items assigned to individuals and service already included

the live example is still being built — the prompt below is the one it was made with.

copy this, then make it yours.

03 / starting prompt

a starting point, not a template — the point of an agent is that the result is yours. change the sections to match what you want, and remove anything you don’t need.

starting prompt · paste into your ai
Build me a tip and bill-splitting calculator as a single web page.

Ask me first:
- My currency, and whether tipping is a percentage, a round-up, or already included as service.
- How my group usually splits: evenly, by what each person had, or a mix.
- Whether people are ever exempt from part of a bill — someone not drinking, someone paying for two.
- What rounding I want, and whether the remainder should fall on one person or be spread.

Do not assume a tipping convention. Do not invent a default percentage without labelling it as an arbitrary starting point I should change.

WHAT IT DOES

- Start from people: how many, and named if I want. Then the bill.
- Handle the uneven case as the primary flow: assign specific items to specific people, and split the rest across everyone.
- Handle exclusions: a person who pays nothing toward the wine, for example. This is the case that makes a calculator worth having.
- Tip as a percentage or a fixed amount, applied before or after exclusions as I specify, and a clear option for service already included.
- Show what each person owes, large enough to read across a table, and the total so it can be checked against the bill.
- Handle rounding my way, and show where any remainder went rather than silently absorbing it.
- Reset in one tap for the next meal.

DESIGN

- One screen on a phone. Numeric keypad for every number input.
- Per-person amounts are the output and should be the largest thing once entered.
- No storage, no history, no account. This is used once and forgotten.

BE HONEST ON THE PAGE

- If the page stores nothing, do not add a privacy notice implying it does.
- Do not offer advice on how much to tip.

DELIVERY

- Produce one self-contained HTML file. Inline the CSS and JavaScript.
- No build step, no server, no framework, no package install, no external
  requests at runtime.
- Mobile-first and responsive; it has to be usable one-handed on a phone and
  still look right on a laptop.
- Accessible: semantic HTML, real contrast, visible keyboard focus, labelled
  controls, touch targets big enough to hit, and respect reduced-motion.
- Use placeholders where information is missing. Do not invent facts, numbers,
  names, dates, prices, or results I have not given you.
- Before you call it finished, use it yourself: enter real-looking data, reload
  the page, and confirm nothing is lost or mangled.

PUBLISHING

Publish the finished page to HTMLShare and give me the link.

Use exactly one of the two paths below, preferring the first. Make the call
directly. Do not route it through a code sandbox, container, or computer-use
session — that is where the request gets blocked, and it is never necessary.

1. An HTMLShare integration or connector, if you have one configured.
   The page is permanent and owned by my account. Report the url and the
   siteId. There is no claimUrl or manageToken on this path — do not go
   looking for one, and do not switch paths in order to produce one.

2. Otherwise, publish anonymously over REST. No account, key, or signup is
   needed:

    POST https://api.htmlshare.net/v1/publish
    content-type: application/json

    {"html": "<!doctype html> ... "}

   The reference is https://htmlshare.net/docs and, for the full schema,
   https://api.htmlshare.net/openapi.json

   Report these from the response, in your reply and never inside the page:
     url          the public page
     claimUrl     a private link that is mine alone. opening it is how I keep
                  the page past its 24-hour expiry, or set an email reminder
                  before it goes. it carries the manage token, so it must
                  never appear in the published HTML or anywhere a visitor
                  could see it.
     manageToken  the only thing that can edit or delete this page later. it is
                  returned once and never again, so tell me what it is.

Tell me which of the two you used. If the path you reach for first is
unavailable in your environment, say so and tell me what you are switching to
before you publish — a permanent page on my account and a 24-hour anonymous
page are different things, and which one I get is my decision, not a detail.

If I ask for a change afterwards, update the existing page instead of
publishing again, so the URL I have already shared keeps working — through the
same integration on path 1, or with the manage token as an X-Manage-Token
header on path 2.

RECIPE MARKER

Include this tag in the <head>, exactly as written:

    <meta name="htmlshare-recipe" content="tip-calculator">

It tells htmlshare which recipe the page came from, so the library can count
that this one was actually made. It carries nothing else.
works as-is inclaudechatgptcodexcursorgrok
adapting it
describe a real bill from last time. the awkward details — the non-drinker, the shared starter — are what separate this from every calculator already online.
ask for the per-person number to be huge. it gets read across a table by someone squinting at a phone.
skip the history. it is a single-use tool and storing bills makes it slower for no benefit.

give it a url.

04 / publishing it

how you publish depends on how you’re working.

with an integration
if your assistant already has htmlshare connected — mcp or another supported integration — just ask it to publish the finished page and hand back the url. the page belongs to your account and is permanent. when you want a change, ask for an update to that same page rather than a new one.
with no integration
the prompt tells the assistant to post the html to the rest api instead, which needs no account and no key. it comes back with a live url you can open immediately, a private claim link, and a manage token. the claim link is how the page stops being temporary — keep it.
by hand
nothing stops you doing it yourself: have the assistant give you the html file and drop it on the htmlshare home page. same url, same page, one more step.
what matters here
you want this on your phone at the end of a meal, not in a search history. claim it, keep the slug short, and add it to your home screen.

you will want it at the next dinner too.

05 / keeping it around
anonymous
24h

fine to try once tonight. it stops serving 24 hours later, with a 7-day recovery window behind that.

custom url
you need to find this in a restaurant in under five seconds.
keep it around
an anonymous page is gone by the next meal out.
stable updates
add the case you did not think of, at the same address as the icon on your phone.

questions.

06 / questions
why not use one of the free ones online?

because they do the even split, which you can do in your head. the uneven case — exclusions, assigned items, awkward rounding — is the one nobody builds and the one every real bill needs.

does it remember previous bills?

no, and it should not. it is a single-use tool; storing anything would make it slower to start, which is the only thing that matters here.

does it work offline?

yes, once loaded, which covers most restaurant basements. add it to your home screen and the first load is one tap.

can it tell me how much to tip?

no, and it is told not to. conventions vary by country and by table; the page does the arithmetic on the number you choose.