Freeframe

Documentation

Tally

v1.0.0Updated Nov 15, 2026A calm, trustworthy fintech SaaS website for invoicing and bookkeeping software, with a live invoice in the hero and a late-payment calculator.

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).

sh
pnpm install
pnpm dev          # http://localhost:3000

Other 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 license

Customizing#

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:

css
--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 in globals.css for h1–h3), and the whole body uses font-variant-numeric: tabular-nums so 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:

ts
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:

ts
{ 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.

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".

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"
ts
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:

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):

sh
SITE_URL=https://www.tally.example pnpm build

Add 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, nav with 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-motion respected (reveals, chart animation, count-up and smooth scrolling are off).
  • ARIA patterns: tabs, pressed buttons for filters and billing, aria-current for navigation and invoice stage, live regions for totals, counts, calculator results and the pricing status.
  • Charts have text alternatives (aria-label or 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#

sh
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 in src/data/office.ts for 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 in src/app/fonts.ts.
  • Links or the social image break under a sub-folder. Build with DEMO_BASE_PATH set to that folder, and SITE_URL set 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.

Search documentation

Search the guides and every template's documentation