cards made from your own notes.

Build me a flashcard page as a single web page, from material I will paste in.

Ask me first:
- For the material itself — notes, a chapter, a vocabulary list, a set of definitions. Ask me to paste it.
- What kind of cards suit it: term to definition, question to answer, both directions, or something else.
- Roughly how many cards I want, if the material is long.
- Whether I want a written-answer mode or just reveal-and-judge.

WRITING THE CARDS

- Write the cards from my material only. Do not add facts from your own knowledge, do not embellish definitions, and do not invent examples.
- If the material is ambiguous or incomplete on a point, leave that card out and tell me what you skipped rather than filling the gap.
- One idea per card. A card testing three things teaches none of them.
- Keep the wording close to my source, so what I learn matches what I will be examined on.
- Tell me how many cards you wrote and from which sections, so I can see the coverage.

WHAT THE PAGE DOES

- Shows one card at a time: prompt, then reveal, then I say whether I knew it.
- Cards I get wrong come back sooner and more often than cards I know. A simple weighting is enough — do not build a full spaced-repetition schedule unless I ask.
- Keyboard controls on a laptop: space to reveal, one key for got it, another for missed it. Tapping on a phone.
- Progress within a session and across sessions, saved in the browser.
- Let me edit a card in the page when I spot one that is wrong, and let me flag it so I remember to check the source.
- Shuffle, restart, and study only the cards I have been getting wrong.

DESIGN

- One card, centred, large type. Nothing else on screen while reviewing.
- Fast: reveal and judge should be instant, because the cost of a slow interaction is compounded ninety times.

BE HONEST ON THE PAGE

- Say the cards were generated from my notes and are worth spot-checking against the source.
- Say progress is stored in this browser only and does not follow me to another device.

STORING THE DATA

- Save everything to localStorage in the browser, automatically, as I go. No
  accounts, no login, no server call.
- On the page, say plainly that data lives in this browser only and does not
  sync to other devices. Do not bury it.
- Give me an "export" button that copies or downloads everything as JSON, and an
  "import" that reads the same JSON back. That is the only way my data can move
  between devices, so it is not optional.
- Never lose what I have already entered. If the stored data is from an older
  version of the page, read what you can rather than throwing it away.

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="flashcards">

It tells htmlshare which recipe the page came from, so the library can count
that this one was actually made. It carries nothing else.