Overview#
Tally is a marketing website template for a SaaS or fintech product: invoicing, expenses and simple
bookkeeping software for freelancers and small studios. The fictional company is Tally Software, Inc., based
on Ionia Avenue in Grand Rapids, Michigan, so prices are in US dollars, exclude sales tax, and the copy uses
American spelling. Times are Eastern (America/Detroit). This is the Next.js version: Next.js 16 with the App
Router, React 19, TypeScript and Tailwind CSS v4, exported as a fully static site, with the same pages, design
and interactions as the HTML version. This guide covers version 1.0.0. See the live demo at
freeframe.dev/templates/tally.
Money and tax copy in the template is deliberately general ("not tax advice", no guaranteed savings). If you use it for a real product, have your own figures and claims checked.
The 6% sales tax in the hero invoice and the pricing toggle is a sample: it is Michigan’s state rate, but what is
taxable varies by state and by item, and many services and hosted software aren’t taxed in Michigan. Set VAT_RATE
and the wording to what applies to you. Some internal names (VAT_RATE, data-vat, data-vat-toggle, the saved
vat value, #gdpr-title) keep their original spelling so they match the HTML version.
The site is a front end only: the forms don't send anything until you connect your own service (see Forms).
Quick start#
Requirements: Node.js 24 or newer and pnpm (npm works too).
pnpm install
pnpm dev # http://localhost:3000Other scripts:
| Script | What it does |
|---|---|
pnpm build |
Static export to out/ |
pnpm start |
Serve out/ (npx serve out) |
pnpm lint |
ESLint |
pnpm typecheck |
next typegen and TypeScript 7 tsc --noEmit |
pnpm build:demo |
Build for freeframe.dev under /demos/nextjs/tally into demo/ |
The fonts are bundled, so nothing loads from the internet.
Pages#
| Route | File | Purpose and features |
|---|---|---|
/ |
src/app/page.tsx |
Live invoice hero (edit quantities, simulate payment), customer wordmarks, three product cards, dark dashboard band with an SVG cash flow chart, set-up steps, testimonials, calculator and pricing teasers, call to action |
/features |
src/app/features/page.tsx |
Product tour in ARIA tabs (invoicing, expenses, bookkeeping, reports), reminder email writer, grid of smaller features |
/pricing |
src/app/pricing/page.tsx |
Monthly / annual switch, sales tax toggle, three plan cards, comparison table with a sticky header, billing and sales tax FAQ |
/calculator |
src/app/calculator/page.tsx |
Late-charge calculator (interest from your terms plus a flat late fee) with an SVG chart, time-saved estimate |
/integrations |
src/app/integrations/page.tsx |
Category filters, search, result count, empty state, bank feed notes, API code sample |
/customers |
src/app/customers/page.tsx |
Featured story with before/after bars, six stories filterable by business type |
/security |
src/app/security/page.tsx |
Key facts, six security practices, privacy notes, sub-processor table, responsible disclosure FAQ |
/changelog |
src/app/changelog/page.tsx |
Updates filterable by type (new, improved, fixed) |
/contact |
src/app/contact/page.tsx |
Validated demo request form, live office hours in Eastern time, next steps, address |
| 404 | src/app/not-found.tsx |
A "reconciliation" card and links to the main pages |
Project structure#
tally/
src/app/
layout.tsx <html>, fonts, skip link, header, <main>, footer, shared helpers
globals.css Tailwind entry: design tokens (@theme) and components
fonts.ts Mona Sans and Azeret Mono, loaded with next/font/local
page.tsx home page; one folder per route for the others
not-found.tsx the 404 page
icon.svg favicon (the tally mark)
opengraph-image.png social sharing image (1200×630)
src/components/
site-header.tsx sticky header, phone menu
site-footer.tsx footer with the sign-up and link columns
logo.tsx the tally mark and wordmark
page-body.tsx <body data-page="...">
invoice-demo.tsx the hero invoice
due-date.tsx the sample invoice's due date (useDue, <DueDate>)
due-prefill.tsx fills the due date in while the page loads
test-month.tsx the month of the last security test (<TestMonth>)
test-month-prefill.tsx fills that month in while the page loads
count-up.tsx numbers that count up once
tabs.tsx the product tour tabs
reminder-writer.tsx the reminder email preview
pricing.tsx billing switch, sales tax toggle and plan cards
calculator.tsx both calculators and the chart
directory.tsx filters, search, counts and the empty state
demo-form.tsx the demo request form
newsletter-form.tsx the footer sign-up
use-validation.tsx inline form validation
use-after-restore.ts keeps controls and results in step when the browser restores a form after Back
success-box.tsx the confirmation that replaces a sent form
office-hours.tsx live office hours on the contact page
faq.tsx questions and answers as <details>
check-icon.tsx the check mark in plan lists and the table
announcer.tsx one live region for screen-reader announcements
reveal-observer.tsx scroll reveals
back-to-top.tsx the back-to-top button
same-page-top.tsx starts a page over when a link opens the page already showing
year.tsx the copyright year
src/data/
nav.ts header, phone menu and footer links
invoice.ts hero invoice lines, limits, notes and the sample tax rate
reminders.ts reminder emails per tone and stage
pricing.ts plans, comparison table, billing FAQ
calculator.ts calculator rules, field ranges, lateClaim()
integrations.ts integration categories and the directory
customers.ts customer stories
changelog.ts product updates
office.ts office hours and time zone
src/lib/
due.ts INVOICE_DUE and the rolling due date
last-test.ts LAST_TEST and the rolling month of the last security test
format.ts money(), num(), plural()
storage.ts saved data keys, store, URL parameters
safe-storage.ts localStorage with an in-memory stand-in
validation.ts form rules and messages
announce.ts announce() for the live region
metadata.ts pageMeta() for titles, descriptions and Open Graph
src/fonts/ the woff2 files and their license texts
public/img/og-image.svg source of the social image
next.config.ts static export, basePath
package.json scripts and browser targets
README.md short introduction
DOCS.md this guide
CHANGELOG.md version history
LICENSE.txt MIT licenseCustomizing#
Brand and colors#
All design tokens are in the @theme block at the top of src/app/globals.css. The ones that matter most:
| Token | Default | Used for |
|---|---|---|
--color-paper |
#f7f6f1 |
Page background |
--color-paper-2 |
#efede5 |
Alternate sections and table group rows |
--color-line / --color-line-strong |
#dcd9ce / #c4c0b2 |
Hairlines, card and input borders |
--color-ink |
#0d1f1b |
Text, primary buttons, dark bands and footer |
--color-ink-soft / --color-ink-faint |
#3c4a45 / #59655f |
Secondary text and captions (AA on paper and white) |
--color-fog |
#a9bab3 |
Secondary text on ink backgrounds |
--color-mint-400 / --color-mint-500 |
#45d99b / #1fc786 |
The accent: fills with ink text on top, chart bars |
--color-mint-700 / --color-mint-800 |
#0a6e4c / #08573d |
Accent text and links on light backgrounds |
--color-amber-*, --color-rose-*, --color-sky-* |
Invoice status chips (due, late, sent) |
To change the accent, edit the mint scale; the dev server picks it up at once:
--color-mint-400: #7cc4ff; /* fills */
--color-mint-700: #1d5f99; /* text on paper */Keep the 700/800 shades dark enough for AA contrast on --color-paper. A few SVGs (the logo in
src/components/logo.tsx, the charts, src/app/icon.svg, the social image) and the calculator chart in
src/components/calculator.tsx use hex colors directly; search for #45d99b and #0d1f1b to update them too.
Typography#
Two fonts, self-hosted from src/fonts/ and loaded in src/app/fonts.ts with next/font/local:
- Mona Sans (variable weight 300–800 and width 75–125%) for everything. Headings use
font-stretch: 112%(set inglobals.cssforh1–h3), and the whole body usesfont-variant-numeric: tabular-numsso figures line up in invoices and tables. - Azeret Mono (weight 400–600) for small labels (
.eyebrow, invoice numbers, chart axes).
Each family has a latin and a latin-ext file, and every face keeps its plain family name, so the CSS and the
inline SVG text can say "Mona Sans" directly. To swap a font, replace the woff2 files, update the src,
weight and family name (in declarations and fallback) in fonts.ts, and change --font-sans or
--font-mono in globals.css. If the new family has no width axis, remove the font-stretch rules or they are
simply ignored. next/font/google also works if you prefer to load from Google.
Content#
Page copy lives in the route files under src/app/. Lists and settings live in src/data/ and src/lib/:
| Where | What it holds |
|---|---|
src/lib/format.ts |
LOCALE and CURRENCY ("en-US", "USD"), used by money() to format every amount |
src/data/invoice.ts |
VAT_RATE (0.06, the sample sales tax rate), INVOICE_LINES (name, price, starting quantity) and INVOICE_DEMO (quantity limits 1–9, stage names, the notes under the invoice) |
src/lib/due.ts |
INVOICE_DUE, the due date of the sample invoice INV-0142 ("YYYY-MM-DD"). null (the default) is a rolling demo date: the Friday 7 to 13 days from today, so the demo invoice is never overdue |
src/lib/last-test.ts |
LAST_TEST, the month of the last independent security test on /security ("August 2026"). null (the default) is a rolling demo date: the most recent August that is over, so the yearly test never looks overdue |
src/data/reminders.ts |
REMINDER_SAMPLE and REMINDER_TONES: the reminder emails per tone (friendly, neutral, firm) and stage (before, due, late) |
src/data/pricing.ts |
PLANS (solo, studio, practice: name, monthly and annual prices in US dollars excluding sales tax, summary, feature list), BILLING_PERIODS, DEFAULT_BILLING, COMPARE (the comparison table) and PRICING_FAQ |
src/data/calculator.ts |
LATE_PAYMENT (points added to the rate entered, days in a year, flat late-fee tiers), TIME_ASSUMPTIONS, CALC_FIELDS (default, minimum and maximum of every input) and CALC_URL_PARAMS |
src/data/integrations.ts |
INTEGRATION_CATEGORIES (also the keys accepted from /integrations?category=) and INTEGRATIONS |
src/data/customers.ts |
STORY_TYPES and STORIES |
src/data/changelog.ts |
UPDATE_TYPES and UPDATES |
src/data/office.ts |
OFFICE: timeZone: "America/Detroit", weekdays 1–5, 9 a.m. to 5:30 p.m. |
src/data/nav.ts |
NAV, MOBILE_NAV, FOOTER_NAV and PAGE_NAMES |
src/lib/storage.ts |
STORAGE_KEYS (see Saved data) |
Changing a price. Edit PLANS. Annual is ten months for twelve, so keep annual = monthly × 10 if you want
the "2 months free" label and the FAQ to stay true:
export const PLANS: Record<PlanKey, Plan> = {
solo: { name: "Solo", monthly: 12, annual: 120, summary: "For freelancers working on their own.", features: [/* ... */] },
// ...
};The cards, the savings and the demo form's plan list all follow PLANS. The "from $10 a month" copy on the home
page and the figures in the FAQ are plain text; change them to match.
Adding an integration. Add an entry to INTEGRATIONS; the counts on the filter buttons are worked out for you:
{ name: "Kittiwake Pay", category: "payments", initials: "KP", color: "#1f4f86", builtByTally: false, description: "Card payments for clients in Canada." },A new category is a new key in INTEGRATION_CATEGORIES (it becomes a filter button and an accepted
?category= value). Customer stories (STORIES) and changelog entries (UPDATES, newest first, each with its
own date) work the same way.
Hero invoice lines. Edit INVOICE_LINES (unit price excluding sales tax, starting qty); totals are worked
out from them. The "$5,766.40" in the reminder writer (REMINDER_SAMPLE.amount and the "Pay" button in
reminder-writer.tsx) is plain text: update it if you change the lines.
Images and artwork#
There are no photos. The logo, customer wordmarks, integration tiles, avatars and charts are inline SVG, and
the invoice, dashboard and receipts are HTML. If you replace an avatar with a photo, keep it square (40×40 on
the home page, 56×56 on the contact page). The social image is src/app/opengraph-image.png (1200×630), picked
up by Next.js for every page; its source is public/img/og-image.svg: edit the SVG and export a new PNG with
any SVG editor. The favicon is src/app/icon.svg.
Navigation, header and footer#
src/components/site-header.tsx and site-footer.tsx render the links in src/data/nav.ts. To add a page,
create src/app/<route>/page.tsx (export metadata with pageMeta()), add it to NAV (the desktop menu, six
links), MOBILE_NAV (the phone menu, which adds Changelog) or FOOTER_NAV, and give it a name in PAGE_NAMES
(the value of <body data-page>). The link to the current page gets aria-current="page" by itself.
In the HTML version every link is a page load. src/components/same-page-top.tsx keeps that behavior where it
matters: a link to the page already showing (Pricing in the header while on /pricing, "Book a demo" after
sending the form) scrolls to the top and starts the page over, so filters, tabs, the FAQ and sent forms reset
and the page reads the address and saved data again.
Features#
Hero invoice demo#
src/components/invoice-demo.tsx, on the home page (#invoice-demo). The minus and plus buttons change a
line's quantity between INVOICE_DEMO.minQty and maxQty; the subtotal, sales tax (VAT_RATE, rounded to the
cent) and total update and the total briefly flashes. Simulate payment moves the invoice from Viewed to
Paid: the chip turns green, the progress track completes, a "Payment received" card appears and the
quantities lock. The button then reads Reset demo. With the starting quantities the total is $5,766.40
($5,440.00 + $326.40 sales tax). Changes are announced in a polite live region; the progress list marks the
current stage with aria-current="step".
The "Due" date is a rolling demo date; see Rolling demo dates.
Product tour tabs#
src/components/tabs.tsx, used on /features: <Tabs panels> owns the selection, <TabList> renders the tab
buttons and <TabPanel id> each panel. Standard ARIA tabs: arrow keys, Home and End move between tabs. The
panel ids are invoicing, expenses, books and reports (TOUR_TABS in src/app/features/page.tsx), and
the selected one is kept in the address, so /features#expenses opens that tab (only ids of the tab panels
are accepted). The pill links at the top of the page (data-tab-link) select a tab and scroll to it.
Reminder writer#
src/components/reminder-writer.tsx, at /features#reminders. Tone buttons (data-tone, aria-pressed) and
stage radios (name="reminder-stage") choose one of the nine emails in REMINDER_TONES; {invoice},
{amount} and {client} are filled from REMINDER_SAMPLE, and {due} ("Friday, October 30") and {dueDay}
("Friday") from the sample invoice's due date, like the "Due" date on the hero invoice. The preview card is a
polite live region.
Pricing switch and sales tax toggle#
src/components/pricing.tsx: <PricingProvider> wraps the page, <BillingSwitch> is the control in the hero
and <PlanCards> the three cards. The billing buttons (data-billing) show either the monthly price or the
annual price divided by twelve, with "Billed $300 yearly" or "Billed monthly" underneath. The saving is
monthly × 12 − annual per plan: $24, $60 and $120 a year. The checkbox data-vat-toggle multiplies
everything by 1 + VAT_RATE (Studio monthly becomes $31.80) and changes the tax note. Whole dollar amounts
drop the cents (money(n, true)). The choice is saved (see below) and ?billing=monthly or ?billing=annual
in the address overrides it; clicking a billing button updates the address. A status line announces the change
to screen readers. The comparison table header is sticky below the site header.
Late-payment calculator#
src/components/calculator.tsx (<LateForm>, <LateResults>) with the rules in src/data/calculator.ts
(lateClaim()). Inputs: amount ($1 to $1,000,000), days overdue (1 to 365, a slider) and the annual interest
rate in your terms (0 to 36%). The US has no single late-payment rate for businesses, so the calculator uses
what the visitor’s own terms say. The rules:
- annual rate = rate entered +
LATE_PAYMENT.margin(0 points); - interest = amount × annual rate ÷ 100 × days ÷ 365, rounded to the cent;
- flat late fee (an example; set your own in
LATE_PAYMENT.compensation) = $25 under $1,000, $50 from $1,000 to under $10,000, $100 from $10,000.
With the defaults ($2,400, 45 days, 12%) the result is $85.51: 12.00%, $35.51 interest, $0.79 a day, $50
late fee. /calculator?amount=12000&days=1 gives $103.95. The chart is inline SVG drawn by <LateResults>: the
late fee as a flat band, interest on top, a marker at the chosen day, over 90 days or the next multiple of 30.
Its text description (data-chart-desc) is rewritten each time. An out-of-range number marks its input
aria-invalid and turns its hint red, and the figures keep using the field's last valid value, so they always
match the slider and each other. When a change to the amount or the days is finished (on leaving the field or
releasing the slider) the address follows, with the value the figures show, so the page can be shared as a link.
Reset to the example restores the defaults, clears the saved values and
removes the URL parameters. Change the default rate in CALC_FIELDS.rate.def (and the defaultValue of the
field in calculator.tsx) to match your own terms; state limits vary, so check them first.
Time-saved estimate#
<TimeForm> and <TimeResults> in src/components/calculator.tsx, at /calculator#time-saved. Minutes today
= invoices × minutes per invoice + late invoices × chasing minutes. With Tally = invoices ×
TIME_ASSUMPTIONS.minutesPerInvoice + late invoices × chasing × (1 − chaseReduction). The defaults give 6.7
hours today, 1.3 hours with Tally and 5.4 hours saved, worth $322 at $60 an hour. Hours read "1 hour" or "2.5
hours".
Filters and search#
src/components/directory.tsx, used on /integrations, /customers and /changelog. <Directory items>
owns the filter; inside it are <FilterPills> (data-filter, aria-pressed, with counts), <DirectoryItem>
(data-integration with data-category), an optional <DirectorySearch> (data-search, matches the words on
the card), <ResultCount> (a live "1 story" / "6 stories") and <DirectoryEmpty> with <ClearFilters>. On the
integrations page urlParam="category" reads ?category=banking (checked against INTEGRATION_CATEGORIES
with an own-key check) and keeps the address in step with the buttons.
Rolling demo dates#
Two dates are worked out from today so the demo never looks out of date. Set either constant to show a fixed date on a real site:
| Constant | Shown in | Rule while null |
Fixed value |
|---|---|---|---|
INVOICE_DUE in src/lib/due.ts |
<DueDate /> on the hero invoice (time[data-invoice-due]), {due} and {dueDay} in the reminder writer |
The Friday 7 to 13 days from today | "2026-10-30" |
LAST_TEST in src/lib/last-test.ts |
Every <TestMonth /> on /security ([data-test-month]: key facts and the first FAQ answer) |
The most recent August that is over: August of this year from September on, otherwise last year's | "August 2026" |
export const INVOICE_DUE: string | null = "2026-10-30";The static pages are built with the dates the template was written with (WRITTEN_DUE, WRITTEN_TEST); the
browser works out the real ones, and <DuePrefill /> and <TestMonthPrefill /> at the end of the pages fill
them in while the page loads, so the written dates never show. The copyright year in the footer (<Year />) is
always the current year. Changelog entries, customer figures and the survey year are history and keep their
real dates.
Office hours#
src/components/office-hours.tsx with officeState() in src/data/office.ts. The time is worked out in
OFFICE.timeZone (America/Detroit) whatever the visitor's time zone, and refreshed every minute. Inside
Monday–Friday, 9 a.m. to 5:30 p.m., it reads "It’s 10:42 a.m. in Grand Rapids and we’re in the office"; outside,
it says when the team replies ("after 9 a.m. this morning", "tomorrow" or "on Monday"). A small script after the
paragraph fills the sentence in while the page loads; if you change the wording in officeText(), change it in
OfficePrefill in the same file too.
Header, menu, reveals and back to top#
The header gains a shadow once you scroll. Below 1024px a menu button (aria-expanded, aria-controls)
opens the phone menu; Esc closes it. Elements with .reveal fade in when scrolled into view
(reveal-observer.tsx; off with reduced motion). <CountUp end={4200} /> counts up once. The back-to-top
button is back-to-top.tsx; remove it from layout.tsx and delete the .back-to-top styles to drop it.
Forms#
Two forms, both using useValidation() from src/components/use-validation.tsx with the rules in
src/lib/validation.ts: errors show under each field, linked with aria-describedby and aria-invalid, and
focus moves to the first problem. After the first submit, fields are checked again as they are fixed.
| Form | Where | Validates |
|---|---|---|
Newsletter (data-form="newsletter") |
src/components/newsletter-form.tsx, footer of every page |
Email required and well formed |
Demo request (data-form="demo") |
src/components/demo-form.tsx, /contact |
Name, work email, team size (radio group) and consent required; message up to 500 characters with a counter |
A required field needs required and an id, takes {...v.field("its-id")} and renders {v.error("its-id")}
where the message goes; data-label names it in the message ("Your name is required."). A radio group is a
<fieldset data-required-group data-label="Team size" data-error-id="d-size">.
/contact?plan=studio (or solo, practice) preselects the plan; the plan buttons on the pricing page link
there. On success each form is replaced by an in-world confirmation: the newsletter asks the visitor to look
out for a confirmation email, and the demo request thanks them by first name, says Noelle will email times for a
call (within two business hours, as the office-hours note promises) and shows a short reference (TA- and four
characters, made in the browser by makeRef(); use your form service's own reference instead if it returns one).
The forms send nothing until you connect them; if your reply times differ, change the message and the
office-hours note together.
To connect a form service such as Formspree, change the callback passed to
useValidation() in demo-form.tsx:
const v = useValidation(async (form) => {
const data = new FormData(form);
const res = await fetch("https://formspree.io/f/your-id", {
method: "POST",
body: data,
headers: { Accept: "application/json" },
});
if (!res.ok) return; // show an error message here, for example in [data-form-status]
const planKey = String(data.get("plan") || "");
setSent({
first: String(data.get("name") || "").trim().split(/\s+/)[0],
planText: hasOwn(PLANS, planKey) ? " about the " + PLANS[planKey as PlanKey].name + " plan" : "",
topics: data.getAll("topics").length,
ref: makeRef("TA"),
});
});Every field has a name, so FormData includes it. The newsletter works the same way in
newsletter-form.tsx (replace setDone(true)). If you remove the static export (see
Building and deploying), you can post to a Route Handler instead
(src/app/api/demo/route.ts with export async function POST(request: Request)) or call a Server Action.
Saved data (localStorage)#
All access goes through safeStorage() in src/lib/safe-storage.ts: localStorage when available, an in-memory
stand-in when the browser blocks it (sandboxed iframes, strict privacy settings), so features keep working for
the visit. store in src/lib/storage.ts reads and writes JSON on top of it.
| Key | Shape | Validation on read |
|---|---|---|
tally:pricing |
{ "billing": "annual", "vat": false } |
billing must be an own key of BILLING_PERIODS, vat a boolean; anything else falls back to annual without sales tax |
tally:calculator |
{ "amount": 2400, "days": 45, "rate": 12, "invoices": 12, "minutes": 20, "late": 30, "chase": 45, "hourly": 60 } |
Each field must be an own key of CALC_FIELDS and a number within its range; invalid fields keep their defaults |
URL parameters win over saved values: /pricing?billing=, /calculator?amount=&days=. Other URL parameters are
/integrations?category= and /contact?plan=; every one is checked with
Object.prototype.hasOwnProperty.call(...) (hasOwn() in src/lib/storage.ts) or a range check, so values like
?plan=constructor are ignored. The static pages show the defaults; saved values and the address apply once the
page is running in the browser.
After Back from another site (or any full page load), browsers put form controls back the way the visitor left
them. useAfterRestore() in src/components/use-after-restore.ts then sets the reminder stage back to the one
the email is written for and counts the restored message on the contact page again; the sales tax box and the
calculator fields already follow the page's state. The forms that are sent keep what the browser restores.
To reset, use Reset to the example on the calculator, or run
localStorage.removeItem('tally:pricing') in the browser console. To stop saving, remove the store.set(...)
calls in pricing.tsx and calculator.tsx.
SEO and sharing#
Each route sets its title and description with pageMeta() from src/lib/metadata.ts, which also writes the
Open Graph title and description; lang="en-US" and theme-color are set in layout.tsx. The social image is
src/app/opengraph-image.png; set SITE_URL when building so its URL is absolute (metadataBase in
layout.tsx):
SITE_URL=https://www.tally.example pnpm buildAdd src/app/sitemap.ts and src/app/robots.ts if you want them (both work with the static export), and set
404.html as your host's not-found page. There is no structured data; SoftwareApplication with offers is a
good fit for a product like this.
Accessibility#
- Skip link, landmarks (
header,navwith labels,main,footer), one<h1>per page and a logical heading order. - Visible focus outlines in the accent color, AA contrast on every surface,
prefers-reduced-motionrespected (reveals, chart animation, count-up and smooth scrolling are off). - ARIA patterns: tabs, pressed buttons for filters and billing,
aria-currentfor navigation and invoice stage, live regions for totals, counts, calculator results and the pricing status. - Charts have text alternatives (
aria-labelor a<desc>that is updated with the numbers); tables have captions and header scopes. - A sent form is replaced by a
role="status"box that takes focus.
When editing, keep one <h1> per page, give new inputs a <label>, and make sure every aria-controls,
aria-labelledby and aria-describedby points at an id that exists.
Building and deploying#
pnpm build # static site in out/
pnpm start # preview out/next.config.ts sets output: "export", images.unoptimized and basePath from DEMO_BASE_PATH (for a
sub-folder, e.g. DEMO_BASE_PATH=/tally pnpm build). Deploy out/ to any static host (Netlify, Cloudflare
Pages, GitHub Pages, S3) or import the repository into Vercel. demo/ is the freeframe.dev demo build and can
be deleted. To use server features (Route Handlers, Server Actions), remove output: "export" and deploy to a
Node.js host or Vercel.
Browser targets#
The browserslist field in package.json lists the oldest browsers the build supports (Chrome and Edge 111,
Firefox 113, Safari 16.4). All of them support oklch() colors, so Tailwind's colors ship as written instead
of being converted to lab() and hex, which rounds some grays slightly differently. Add older browsers there if
you need them; the build then adds color fallbacks.
TypeScript 7 setup#
@typescript/native provides TypeScript 7's tsc for pnpm typecheck; typescript is aliased to
@typescript/typescript6 because typescript-eslint and parts of the Next.js toolchain need the TypeScript 6
API. Replace both with typescript@7 once typescript-eslint supports it.
Troubleshooting#
- Prices or the calculator don't remember choices. The browser is blocking storage (private mode or a sandboxed preview), so choices last only for the visit. That's expected.
- A shared pricing link opens on the wrong period.
?billing=overrides the saved choice; remove it from the link. - The page shows the example for a moment before my saved numbers. The static page is built with the defaults; saved values and URL parameters apply when the page starts in the browser.
- The office hours text looks wrong. It uses Eastern time (
OFFICE.timeZone); change the time zone and hours insrc/data/office.tsfor another location. - A Tailwind class written in a template string has no effect. Keep class names as whole strings
(
open ? "hidden h-5 w-5" : "h-5 w-5"); Tailwind can't find a class glued to a${...}expression. - A form shows its confirmation but nothing arrives. It sends nothing until you connect it; see Forms.
- Fonts fall back to the system font. Check that
src/fonts/still has the woff2 files named insrc/app/fonts.ts. - Links or the social image break under a sub-folder. Build with
DEMO_BASE_PATHset to that folder, andSITE_URLset to your domain.
License#
MIT. The code and all included artwork (logo, wordmarks, integration tiles, avatars, charts, mock-ups and social image) are free for personal and commercial use; see LICENSE.txt in the download.
Mona Sans and Azeret Mono are licensed under the SIL Open Font License (see src/fonts/).
Tally, Tally Software, Inc. and every business, person and integration named in the template are fictional placeholders.