Skip to content
Merged
16 changes: 3 additions & 13 deletions app/Http/Controllers/FaqController.php
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,7 @@
use Inertia\Inertia;
use Inertia\Response;

/**
* The FAQ, `/faq` and `/vi/faq` (sitemap §A.1, design-system §8.12).
*
* The questions and answers are page copy in `content/{locale}/faq.json`.
* Every fact an answer states (a requirement, a seat minimum, a refund
* window, an engine or feature name, an outbound link) is a `{token}` or a
* link reference in that copy, filled from the values sent here, so an answer
* cannot disagree with the pricing, platform and privacy pages that read the
* same files.
*
* There is no FAQPage markup (architecture §1.6): the page is a `WebPage`.
*/
// Every fact an answer states is a {token} or a link tag filled from these props, so the FAQ cannot disagree with the pages that read the same files.
class FaqController extends Controller
{
public function __invoke(ContentRepository $content, PlatformCatalog $platforms, SiteFacts $facts): Response
Expand All @@ -34,6 +23,7 @@ public function __invoke(ContentRepository $content, PlatformCatalog $platforms,
'ios' => $platforms->summary('ios'),
'macLanguages' => $this->stringList($platforms->find('mac')['appLanguages'] ?? []),
'linuxLanguages' => $this->stringList($platforms->find('linux')['appLanguages'] ?? []),
'linuxDistributions' => $this->stringList(array_column($platforms->find('linux')['distributions'] ?? [], 'name')),
'iosLanguages' => $this->stringList($ios['appLanguages'] ?? []),
],
'facts' => [
Expand All @@ -43,7 +33,7 @@ public function __invoke(ContentRepository $content, PlatformCatalog $platforms,
'importApps' => $facts->connectionImportApps(),
'localAiProviders' => $facts->localAiProviders(),
'paidFeatures' => $facts->paidFeatureNames(),
'commerce' => $facts->commerce(),
'supportBusinessDays' => $facts->commerce()['supportBusinessDays'],
],
'links' => $facts->links(),
'organizationProfiles' => $facts->organizationProfiles(),
Expand Down
7 changes: 6 additions & 1 deletion app/Http/Controllers/SecurityController.php
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,14 @@ public function __invoke(ContentRepository $content, FeatureFacts $facts, SiteFa

return Inertia::render('Security', [
'content' => $page,
'facts' => $this->values($facts->for($page)),
'facts' => [
...$this->values($facts->for($page)),
'localAiProviders' => $site->localAiProviders(),
],
'replyDays' => $site->commerce()['supportBusinessDays'],
'links' => [
...$links,
'securityEmail' => $site->securityEmail(),
'securityPolicy' => $links['github'] === null ? null : $links['github'] . '/security/policy',
'securityAdvisory' => $links['github'] === null ? null : $links['github'] . '/security/advisories/new',
'securityTxt' => SecurityTxtController::PATH,
Expand Down
13 changes: 5 additions & 8 deletions app/Http/Controllers/SecurityTxtController.php
Original file line number Diff line number Diff line change
Expand Up @@ -7,27 +7,24 @@
use App\Support\Localization\LocalizedUrl;
use Illuminate\Http\Response;

/**
* `/.well-known/security.txt` (RFC 9116).
*/
// `/.well-known/security.txt` (RFC 9116): the contacts in order of preference, then the policy on /security.
class SecurityTxtController extends Controller
{
public const PATH = '/.well-known/security.txt';

/**
* The date the contact below stops being vouched for. Move it forward,
* less than a year ahead, after checking the address still reaches someone.
*/
// Move it forward, less than a year ahead, after checking the contacts still reach someone.
public const EXPIRES = '2027-10-01T00:00:00Z';

public function __invoke(SiteFacts $facts): Response
{
$email = $facts->links()['email'];
$email = $facts->securityEmail();
$github = $facts->links()['github'];

abort_if($email === null, 404);

$lines = [
'Contact: mailto:' . $email,
...($github === null ? [] : ['Contact: ' . $github . '/security/advisories/new']),
'Expires: ' . self::EXPIRES,
'Preferred-Languages: en, vi',
'Canonical: ' . LocalizedUrl::base() . self::PATH,
Expand Down
8 changes: 8 additions & 0 deletions app/Services/Content/SiteFacts.php
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,14 @@ public function links(): array
];
}

// `/security` and security.txt, apart from the support address.
public function securityEmail(): ?string
{
$email = $this->json('facts.json')['support']['securityEmail'] ?? null;

return is_string($email) && filter_var($email, FILTER_VALIDATE_EMAIL) !== false ? $email : null;
}

/**
* @return array{name: string, country: string|null, countryCode: string|null}|null
*/
Expand Down
2 changes: 1 addition & 1 deletion docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ database and no credentials: every page is built from markdown in
/vi/… every page above, in Vietnamese, where it exists
/robots.txt /sitemap.xml
/llms.txt llmstxt.org, English, built from the page registry
/.well-known/security.txt RFC 9116; `SecurityTxtController::EXPIRES` is moved by hand
/.well-known/security.txt RFC 9116: security@ then a private GitHub advisory; `SecurityTxtController::EXPIRES` is moved by hand
```

Pages resolve by convention from `resources/js/pages`. The shared
Expand Down
2 changes: 1 addition & 1 deletion docs/rebuild/design/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -633,7 +633,7 @@ The ten `ProFeature` cases, in display order. `highlight` marks the examples beh
{
"links": { "github": "…", "appStore": "…", "sponsorsProgram": "…", "discord": "…", "x": "…", "facebook": "…",
"telegram": "…", "docs": "https://docs.tablepro.app", "changelog": "…", "issues": "…", "productHunt": "…" },
"support": { "email": "hello@tablepro.app" },
"support": { "email": "hello@tablepro.app", "securityEmail": "security@tablepro.app" }, // security@: /security and security.txt
"openSource": { "license": "AGPL-3.0" },
"ai": { "providers": ["…"] }, // names, in the app's order
"mcp": { "host": "127.0.0.1", "enabledByDefault": false, "toolGroups": ["…"],
Expand Down
39 changes: 30 additions & 9 deletions docs/rebuild/design/design-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -507,7 +507,6 @@ Decided by the owner on 2026-10-06, after a rendered survey of grid-line sites (
- the homepage: the hero's two download actions, the featured engines, the sponsors, the workflow rows (from 1280px each sets its text in 4 columns beside its capture in 8, so one divider runs down the section; a detail row is two cells, 5 / 7 from 1024), the safety row, the platform block, the plans and the closing actions
- `/pricing`: the plans (`PricingPlans` is the same component)
- `/download`: the release row
- `/faq`: one row per topic, the topic beside its questions

Prose sections (`#ai`, `#switch`, articles) stay unlined inside their joins. Cards stay cards where a block holds a single object (the database facts card, callouts, code blocks, account panels).

Expand Down Expand Up @@ -703,9 +702,9 @@ Repo key:

#### 5.3.7 FaqList

- One column. In a section its rows run from rail to rail with their text at `text` width (`frame-rows-text`, §4.7); on `/faq` it fills the questions cell beside its topic, with rows from the cell divider to the rail.
- One column. In a section its rows run from rail to rail with their text at `text` width (`frame-rows-text`, §4.7). `/faq` no longer uses it: its questions are bands (§8.12).
- Each item:
- The question is an `h3` (or `h2` on `/faq` under group headings, which use the `h2` style).
- The question is an `h3`.
- The answer is `body` in `--foreground`, 8px below its question.
- Items are separated by a 1px `--rule` with 24px of padding.
- All answers are visible. Answers come from data, with named interpolation.
Expand Down Expand Up @@ -1614,16 +1613,22 @@ End Contact line (hello@tablepro.app)

Print styles apply.

### 8.12 FAQ (`/faq`)
### 8.12 FAQ (`/faq`, every locale)

Rebuilt 2026-11-08 on the grid of the feature pages (§8.2): `AreaNav`, `FeatureHero`, `BandFrame`, `MoreItem`, `ClosingFrame`.

```
PageHeader H1 · lead · jump links: sitemap §A.1's categories and ids: #general · #platforms · #databases · #licensing ·
#privacy · #account · #switching
per group one row of two cells (§4.7): H2 in cols 1–4 (sticky from 1024) │ FaqList in cols 5–12, rows from the cell
divider to the rail (questions h3, answers visible). Below 1024 the heading cell stacks above its questions
Callout note a block of its own: Didn't find it? Email us · Live chat (loads only when clicked)
Topic row Product · Pricing · Platforms · Databases · Privacy · Support (#id links; scrolls sideways on a phone)
Hero H1 · one sentence; no actions
Bands ×6 cols 1–3: H2, the topic cols 4–12 at 42rem: questions (h3, 17/600) with the answer open below (16, muted),
32px apart; no rules, no accordion. Pricing ends with one line to /pricing#faq
#contact cols 1–3: Contact cols 4–12: "Email {email}, or report a problem on GitHub." (30px) · Start a live chat
```

- An answer is two sentences and one link at most; links sit inside the sentence (`useContentTags` with `<Trans>`).
- An id that moved lands through `also`: a question's old ids on the question, a topic's on its band, the billing questions' on the Pricing line, and `#students-teachers` on the Pricing band while the education program is closed.
- Bands rise into place as they scroll in; reduced motion turns it off.

### 8.13 404 and 410 (both apps)

```
Expand Down Expand Up @@ -1766,6 +1771,22 @@ cols 9-12 Card "Details": Publisher · Category · Works with · TablePro app

`/vi/integrations/{slug}` and the other languages answer 404 with a link to the English page.

### 8.23 Security (`/security`, every locale)

Rebuilt 2026-11-08 on the same grid as §8.12.

```
Topic row Credentials · What leaves your device · AI & MCP · Updates & signing · Safe Mode · Open source · Report a vulnerability
Hero H1 · one sentence; no actions
Bands ×7 cols 1–3: H2 that states the band's fact cols 4–12 at 42rem: text, then at most two limits (15, muted)
and the band's links. #network and #ai-mcp add a table across cols 4–12, the limits and links under it
#report the last band: security@ or a private GitHub advisory · reply time · what to include · no bug bounty
```

- The tables are DataTables flush with the text: no header fill, no inset on the outer columns. Below 640 they keep the
first two columns and fold the rest under the second as labelled lines (§5.3.10, priority columns).
- No diagram, badges or certification claims.

---

## 9. Sharing between the two repositories
Expand Down
5 changes: 4 additions & 1 deletion docs/rebuild/design/sitemap.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,8 +80,9 @@ Column notes:
| `/download` | `/vi/download` | Platform | "download TablePro", "TablePro mac", `brew install tablepro`. Linked from the docs navbar, the purchase email and the org README | "Download TablePro" | 1) The app icon and the H1 2) Platform switch, the visitor's platform open first (design-system §8.7): **Mac** (`#mac`): Download for Mac with the DMG size from the release API, macOS 13 Ventura or later, Apple silicon or Intel, the updates line, copyable `brew install --cask tablepro` with a note that Homebrew can trail a release, Verify your download; **Linux** (`#linux`, once released): the beta note, Ubuntu | Fedora | Flatpak | Files; **iPhone & iPad** (`#ios`): App Store badge, iOS/iPadOS 18 or later, free with no in-app purchases, link to /ios. `#updates` lands on the switch 3) Release row: release notes (`#release-notes`), older versions and build from source (`#older-versions`), Windows not available with no date (`#other-platforms`) | platforms; GitHub releases API (`releases/latest`, cached, literal fallback) | none (none of the reference download pages shows a screenshot) | /ios, /features, /pricing, docs `/installation` ↗, docs `/changelog` ↗ | yes (pair) |
| `/ios` | `/{locale}/ios` | Platform | "TablePro iPhone/iPad", "database client iPhone", "PostgreSQL/MySQL app iOS". Linked from the App Store listing (seller URL `/`) | "TablePro for iPhone and iPad" | Rebuilt 2026-11-08 on the feature-page grid, about 500 words: 1) Hero (`#top`): H1, one sentence, the App Store badge and one requirement line (free, no in-app purchases, iOS and iPadOS 18 from data), then the iPad and the iPhone in Apple's frames side by side at their real relative size, the iPhone alone on a phone 2) Databases (`#databases`): the engines the app opens as linked words from `iosEngines`; Redshift opens when synced; SQLite and DuckDB files 3) Six bands: Connect securely (`#connect`, old `#security`), Browse and edit (`#browse`), Run queries (`#query`), Safe Mode (`#safe-mode`), Shortcuts and widgets (`#shortcuts`, old `#automation`), With your Mac (`#mac`); an iPhone beside its text, an iPad or the sync diagram below it 4) Also (`#more`): what stays on the Mac (`#limits`, old `#known-issues`), On iPad (`#ipad`), Privacy (`#privacy`, one sentence), Open source 5) Closing (`#get`): one sentence and the badge. No known issues, no FAQ, no countries | platforms (`ios.*`), engines (`ios` fields), facts (Safe Mode levels, iOS limits) | ios-hero-ipad, ios-hero-iphone, ios-connect, ios-browse, ios-query, ios-safe-mode, ios-shortcuts, diagram-icloud-sync | /download, /privacy#ios-app, every engine page | yes (all locales) |
| `/pricing` | `/vi/pricing` | Commerce | "TablePro price", "license", "team"; also visitors who arrive from in-app upgrade links through `/#pricing` | "Pricing" | 1) One line: free at work too; Pro and Team add features to the Mac app 2) **Plans** (`#plans`): Free, Pro and Team cards, Pro leading; Enterprise as one row; monthly/yearly/one-time toggle; unit on the price line; seat stepper with the API maximum; Buy starts `POST /checkout`; refund and tax as one line; discount code 3) **What a paid plan adds** (`#features`): the paid features grouped by plan, each linked to its feature page, plus Macs, Priority support and everything else 4) **Questions** (`#faq`): one grouped FAQ, collapsed: Licenses (`#license`), Billing and refunds (`#billing`, `#refunds`), Teams (`#team`), Free and open source (`#at-work`, `#education` while open, `#open-source`, comparisons) | pricing; FAQ data (licensing subset) | none | each paid feature's page anchor, /refund-policy, /account?locale=, /download, /faq#licensing, /terms | yes (pair) |
| `/faq` | `/vi/faq` | Support | Pre-purchase and support questions: "is TablePro free", "offline", "Windows", "lost license key" | "Frequently asked questions" | Categories in this order: General (`#general`) · Platforms (`#platforms`) · Databases (`#databases`) · Pricing and licenses (`#licensing`) · Privacy and network (`#privacy`) · Account and team (`#account`) · Switching (`#switching`). Answers take values from data placeholders. "Lost your key?" and "Manage seats" point to /account | faq copy (en/vi) plus pricing, platforms, engines | none | /pricing, /download, /ios, /privacy, /account?locale=, /databases, /compare | yes (pair) |
| `/faq` | `/{locale}/faq` | Support | Pre-purchase and support questions: "is TablePro free", "Windows", "Linux", "where are my passwords" | "Frequently asked questions" | Rebuilt 2026-11-08 on the feature-page grid, 22 questions and about 950 words, each answer two sentences and one link at most, all open: 1) Topic row (scrolls sideways on a phone) 2) Hero (`#top`): H1 and one sentence, no actions 3) One band per topic: Product (`#product`, old `#general`) · Pricing (`#pricing`, old `#licensing`, `#account`: exactly four questions, then one line to /pricing#faq carrying the ids of the billing, seat and license-key questions that live only there) · Platforms (`#platforms`) · Databases (`#databases`, old `#switching`) · Privacy (`#privacy`: one sentence each, linking /security) · Support (`#support`) 4) Contact (`#contact`): email, GitHub issues and live chat. Every old question id lands (`FaqTest`). No prices, currencies or version numbers typed | faq copy plus platforms, engines, paid features, pricing (Priority support's business days), facts (import apps, local AI providers) | none | /pricing, /pricing#faq, /download, /ios, /security, /databases, /compare, /account?locale= | yes (all locales) |
| `/about` | `/{locale}/about` | Trust | "who makes TablePro", "TablePro developer"; readers checking who is behind the app before they buy or connect it to production | "About TablePro" | 1) Who makes it (`#maker`): the TablePro team (no person or city), what it makes, where it publishes (App Store, GitHub Sponsors), the repository's creation date 2) How it is funded (`#funding`): paid licenses and sponsors, no investors, no data sold 3) Source code (`#source`) 4) Contact (`#contact`): support email, GitHub Issues and Discussions 5) Policies (`#policies`) 6) Brand (`#brand`): how the name is written, the logo file | facts (publisher, links, repository date) | none | /pricing, /#sponsors, /privacy, /terms, GitHub, GitHub Sponsors, App Store | yes (all locales) |
| `/security` | `/{locale}/security` | Trust | "is TablePro safe", "where does TablePro store passwords", "TablePro telemetry", "report a vulnerability"; security reviewers before production use | "Security" | Rebuilt 2026-11-08 on the feature-page grid, about 900 words, each band's heading stating its fact, at most two limits per band: 1) Topic row 2) Hero (`#top`): H1 and one sentence, no actions 3) Credentials (`#credentials`): Keychain, Secret Service on Linux, iCloud Sync 4) What leaves your device (`#network`): one table, destination · what is sent · when · how to turn it off 5) AI & MCP (`#ai-mcp`, old `#mcp`): a table of request paths 6) Updates & signing (`#updates`, old `#distribution`): Mac signing and Sparkle, Linux packages and attestations, plugins, the App Store 7) Safe Mode (`#safe-mode`) 8) Open source (`#open-source`) 9) Report a vulnerability (`#report`, linked by the privacy policy in every locale): `security@` or a private GitHub advisory, the reply time from data, no bug bounty. No badges, diagram or certification claims; no version numbers | security copy plus facts (Safe Mode levels, MCP host, local AI providers, `support.securityEmail`), pricing (business days) | none | /privacy#apps, /features/connections, /features/ai-mcp, /features/data-editing, /download#updates, docs, security.txt | yes (all locales) |

### A.2 Features

Expand Down Expand Up @@ -631,6 +632,8 @@ Redesigned 2026-11-07 (owner): stacked bands on the Home grid, Mac windows only,
- The page never starts a download on its own. The after-click panel appears only when the browser has been handed the file.
- If the release API fails, a server-rendered GitHub Releases link is the fallback.
- **/ios.** Describes App Store 1.0 only, on the feature-page grid (owner, 2026-11-08). Facts come only from data, and engines are named, never counted. The app is said to be free once. Nothing that exists only at HEAD, such as the iPad side-by-side layout or the jump-host message, is described, and the page names no country: `storefrontExclusions` (France) is read by `release:check` only. Every old anchor still lands (`IosTest`).
- **/faq.** Rebuilt 2026-11-08 (owner): about 22 questions in six topic bands, every answer open, two sentences and one link at most. Pricing keeps four questions (free, what a paid plan adds, at work, students and teachers); billing, invoices, refunds, seats, license keys and offline checks live only on /pricing and /teams, and their old /faq ids land on the line that points there. Privacy answers are one sentence linking /security. Accounts are the default; older Mac builds get one sentence. Facts come through `{tokens}`; nothing typed as a price, currency or version.
- **/security.** Rebuilt 2026-11-08 (owner): seven bands, headings that state facts, at most two limits each, one table of what leaves the device and one of AI request paths, Mac and Linux described side by side. Reporting goes to `security@tablepro.app` (also security.txt's first `Contact`) or a private GitHub advisory, with the reply time from `pricing.json` and no bug bounty. No SOC 2, certifications, badges or diagram. Every old section and item id lands (`SecurityPageTest`).
- **/pricing.**
- Unit, cycle, minimum, total and currency are stated in words.
- It says what happens when payment stops, per cycle.
Expand Down
Loading