Guide
Check a filing, read the report, keep a copy.
Everything the checker does, in the order you meet it. The checker is one page; this guide is the long form of what it already says.
What it checks
citefold reads a filing and reports what the filing says about itself. It finds every citation, ties every short form (Id., supra, a bare case name) back to the full citation it shortens, and grades what it finds.
Two kinds of finding come back, because they are not equally actionable:
- Impossible. A defect provable from the brief alone. A pinpoint cite points inside an opinion, so it can never precede the page the opinion begins on; a brief citing
Brown v. Board of Educ., 347 U.S. 483and thenBrown, 347 U.S. at 12contradicts itself. The check runs on pinpoints in full citations, short forms,supra, andId.alike, and a pinpoint into a parallel reporter is checked against that reporter's own first page. - Unresolved. A citation that could not be tied to an authority: an
Id.with nothing before it or following a citation that itself failed to resolve, a short form orsupranaming a case never cited in full, a short form whose volume or reporter matches no full citation of that name, asuprathat two cited cases could equally claim. Each is reported with its text so a person can look.
- A citation in the briefa full citation, a short form,
supra, orId. - Can it be tied to an authority the brief cited in full?
- unresolvedNo: reported for a person to look atan
Id.with nothing before it, a short form naming a case never cited in full, asupratwo cases could claimYes: resolved to its authoritythe paragraph joins that authority's entry in the table - Does its pinpoint fall before the page the opinion begins on?
- impossibleYes: the brief contradicts itselfprovable from the brief alone; no outside source neededNo: the citation standsexistence against an external source is not checked, and the report says so
What it does not check, stated plainly: whether a cited case exists in an external database (the report says so every time), whether a citation is good law, and whether it supports the proposition it is cited for. None of that can be checked by this method, and the checker never implies otherwise.
Check a filing
- Open the checker, on this site or from a copy you saved. It needs no account and no network; disconnect and it still works.
- Drop a Word document (
.docx) on the panel, or click the panel to choose one. The document is read in your browser's memory and never sent anywhere. - Read the report that appears under the panel: the verdict line, the findings, and the table of authorities.
No document at hand? Try the worked example, the button under the panel, runs a five-paragraph passage with one defect of each kind through the same report, so you can see what each finding looks like before you commit a filing of your own.
Fix something in Word and drop the file again: the checker re-reads it every time, even when the name is the same.
Read the report
The report opens with the document's name and a line in the machine's voice: how many paragraphs were read and how many distinct authorities were found. Then:
- The verdict. Either No citation defects across N authorities or a count: 1 impossible, 1 unresolved, across 3 authorities. Every verdict ends with the same sentence: existence against an external source is not checked.
- The findings. One card each, tagged impossible or unresolved, with the reason in plain words and the cited text with its paragraph number. Show it in the brief opens the paragraph with the cite marked in place, so you read the sentence the finding is about, not only the citation string.
- The table of authorities, described in the next section.
Brown v. Board of Educ., 347 U.S. 483 and later Brown, 347 U.S. at 12; page 12 of the volume lies before the page where Brown begins, so it cannot be in Brown. The brief contradicts itself, and no outside source is needed to see it.What to do with each kind: an impossible finding is a defect in the brief; fix the citation. An unresolved finding needs an eye: either the brief cites something it never cited in full, or the citation is written in a shape the checker does not read (see when something is refused); in both cases a person decides.
The table of authorities
Under the findings, every authority the filing cites, grouped as cases, statutes, and regulations, with the places it appears. An authority cited on five or more paragraphs is listed as passim, following the Bluebook rule, rather than by enumeration.
The numbers are paragraphs, not pages. A .docx carries no page numbers: Word assigns them when it lays the document out. The report and the table therefore point at paragraphs, and the command line accepts a paginated .json (an object with a pages array of strings) when you have real pages.
The free tier and the licence
Free for filings citing up to 15 authorities, with no feature held back: every check runs and every finding shows. $79, paid once, for filings of any size.
Past 15 authorities the report shows the count and a way to buy; every check still runs the moment a key is in place. A licence key is a signed string. Paste it into the Licence key field under the panel (the field is there in the free tier too); the key is verified offline against a public key compiled into the page, so entitlement never requires a network call. The field keeps the key in your browser's local storage, on your machine, so you paste it once.
After buying, the key is issued against the order and sent to the order's email address. Newer builds of the checker keep the same public key, so a licence bought once verifies in every later version.
- Lemon SqueezyCheckout$79 once; the receipt and tax invoice come from the merchant of record
- The orderA key, issued against itsent to the order's email address, a signed string
- The checkerPaste it onceinto the licence field, or pass it to the command line; kept in your browser's local storage, on your machine
- Your machineVerified offlineagainst the public key compiled into the page; no activation server exists
If the field says the key was not accepted, the reason is printed beside it: not a citefold key (the pasted text is something else), key is damaged (a piece is missing; paste the whole line from the email, line breaks and invisible characters are tolerated), or signature does not match (the key was not issued for this product).
Copy, print, keep a copy
Copy report puts the report on the clipboard as text, in the shape the command line prints: the document, the findings, the result line, the table. When a browser will not grant the clipboard, the same text opens in a box to select and copy. Print prints the report alone, without the instrument around it.
The checker is one self-contained HTML file. Save it (the Download button on the front page) and it works offline forever. To verify a copy, compare its SHA-256 checksum with the one printed on the front page beside the download:
| Windows | certutil -hashfile citefold.html SHA256 |
| macOS | shasum -a 256 citefold.html |
| Linux | sha256sum citefold.html |
The front page also prints the current build's version; the checker prints its own in its footer. A newer build replaces the file and keeps your key.
The command line
The same engine runs as a command line, for anyone who wants it in a script. It ships with the source repository:
node bin/citefold.mjs check <document> report citation defects
node bin/citefold.mjs table <document> print the table of authoritiesBoth accept .docx; the command line also accepts .txt, .md, and a .json file carrying a pages array. The licence comes from --licence <key>, the CITEFOLD_LICENCE environment variable, or ~/.citefold-licence, in that order.
0 | clean |
1 | findings reported |
2 | the document could not be read |
3 | the filing exceeds the free tier and no licence was given |
When something is refused
- A PDF. The checker reads Word documents. Save the brief as
.docxfrom Word and drop that file; a PDF is refused by name. - A legacy
.doc, or a password-protected file. Re-save it in Word as an unprotected.docx. - A zip64 archive. Some non-Word tools write this format regardless of size; re-save the document as an ordinary
.docx. - The document body contains no text. The file has no paragraphs to read; check that the brief was saved, not an empty template.
- A citation the checker does not read. The grammar anchors on the shapes citations take: party names around
v., procedural captions likeIn re, volume and page digits, a year in parentheses, andU.S.C.andC.F.R.statutes. It carries no reporter whitelist, so an unfamiliar reporter still parses, but a citation written outside those shapes is neither counted nor checked, and a short form pointing at it comes back unresolved. The fixtures exercise federal and California citations. - Nothing happens on drop. The panel accepts one
.docxat a time; click it to choose the file instead. - Copy report does nothing. The browser denied the clipboard; the report's text opens in a box under the buttons to select and copy.
Privacy
Your document is read in your browser and sent nowhere: the build refuses a page that could make a network request, and the page carries a Content Security Policy under which the browser blocks every connection, on this site and in a saved copy alike. The full statement is on the privacy page.
- 1The Word filethe brief, as Word saved it
- 2The browser tabcitefold.html reads it in memory
- 3The reportfindings and the table, on screen or printed
Questions
Write to citefold@beintex.dev.