Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 13 additions & 37 deletions app/Http/Controllers/IntegrationController.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
use App\Support\Content\ContentRepository;
use App\Support\Content\IntegrationCatalog;
use App\Support\Localization\Locales;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\App;
Expand All @@ -15,34 +14,29 @@

/**
* @phpstan-type Icon array{src: string, width: int, height: int}
* @phpstan-type Summary array{slug: string, name: string, publisher: string, tier: string, categories: list<string>, platforms: list<string>, closedSource: bool, tagline: string, keywords: list<string>, icon: Icon|null}
* @phpstan-type Filters array{q: string|null, category: string|null, platform: string|null, tier: string|null}
* @phpstan-type Summary array{slug: string, name: string, publisher: string, tier: string, group: string, closedSource: bool, tagline: string, icon: Icon|null}
*/
class IntegrationController extends Controller
{
private const array TIERS = ['official', 'partner', 'community'];

// The registry names the OS a TablePro app runs on; the site names the app.
private const array PLATFORMS = ['macos' => 'mac', 'ios' => 'ios', 'ipados' => 'ios'];
private const array PLATFORMS = ['macos' => 'mac', 'linux' => 'linux', 'ios' => 'ios', 'ipados' => 'ios'];

private const array NETWORK = ['none', 'local', 'internet'];

private const array PAYMENT = ['free', 'optional', 'paid'];

private const int QUERY_LENGTH = 100;

private const string IMAGES = '/images/integrations/';

public function index(Request $request, ContentRepository $content, IntegrationCatalog $catalog): Response
public function index(ContentRepository $content, IntegrationCatalog $catalog): Response
{
$locale = App::getLocale();
$page = $content->page('integrations/index', $locale);
$listed = $this->listed($catalog, $page, $content, $locale);

return Inertia::render('Integrations/Index', [
'content' => Arr::except($page, ['taglines', 'show']),
'integrations' => $listed,
'filters' => $this->filters($request, $listed),
'integrations' => $this->listed($catalog, $page, $content, $locale),
]);
}

Expand Down Expand Up @@ -94,16 +88,21 @@ private function listed(IntegrationCatalog $catalog, array $page, ContentReposit
continue;
}

// The hub groups an entry under its first category the content file labels, in the registry's order.
$group = array_values(array_intersect($integration['categories'], $categories))[0] ?? null;

if ($group === null) {
continue;
}

$listed[] = [
'slug' => $slug,
'name' => $integration['name'],
'publisher' => $integration['publisher']['name'],
'tier' => $this->tier($integration),
'categories' => $this->known($integration['categories'], $categories),
'platforms' => $this->platforms($integration['platforms']),
'group' => $group,
'closedSource' => $integration['closedSource'] === true,
'tagline' => $tagline,
'keywords' => array_values(array_filter($integration['keywords'] ?? [], 'is_string')),
'icon' => $this->image($integration['icon']['128'] ?? null),
];
}
Expand All @@ -126,30 +125,6 @@ private function taglines(array $page): array
return array_filter($taglines, fn(mixed $tagline): bool => is_string($tagline) && trim($tagline) !== '');
}

/**
* @param list<Summary> $listed
* @return Filters
*/
private function filters(Request $request, array $listed): array
{
$value = function (string $key, string $field) use ($request, $listed): ?string {
$value = $request->query($key);
$present = array_merge(...array_map(fn(array $entry): array => (array) $entry[$field], $listed));

return is_string($value) && in_array($value, $present, true) ? $value : null;
};

$q = $request->query('q');
$q = is_string($q) ? trim(mb_substr(trim($q), 0, self::QUERY_LENGTH)) : '';

return [
'q' => $q !== '' ? $q : null,
'category' => $value('category', 'categories'),
'platform' => $value('platform', 'platforms'),
'tier' => $value('tier', 'tier'),
];
}

/**
* @param array<string, mixed> $integration
* @param array<string, mixed> $page
Expand Down Expand Up @@ -182,6 +157,7 @@ private function detail(array $integration, array $page, IntegrationCatalog $cat
'platforms' => $this->platforms($integration['platforms']),
'versions' => [
'mac' => $this->text($versions['macos'] ?? null),
'linux' => $this->text($versions['linux'] ?? null),
'ios' => $this->text($versions['ios'] ?? $versions['ipados'] ?? null),
],
'host' => is_array($host) ? [
Expand Down
34 changes: 18 additions & 16 deletions docs/rebuild/design/design-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -1750,32 +1750,34 @@ None of these pages is indexed (`noindex`). The single robots tag comes from the

### 8.21 Integrations hub (`/integrations`, every locale)

Rebuilt 2026-11-08 on the feature-page grid.

```
PageHeader H1 · lead · Build an integration ↗ (docs)
IntegrationFilters: Search · Category · TablePro app · Type · [Show results]
p role=status "{count} integrations"
IntegrationList one row per entry, Official first; or EmptyState "No integrations match" · Clear filters →
#publish How to submit ↗ · Listing policy ↗ (the registry on GitHub) · owners' names and logos line
Hero H1 · one sentence · Build an integration ↗ (docs)
#{category} one band per category, in the order the sorted list first reaches it (ai-clients, command-line, …)
cols 1–3: the category label cols 4–12: ruled rows, mark 40 · name 20px · tagline · "By {publisher}" or "{tier}, by {publisher}"
#publish closing band: one sentence · How to submit ↗ · Listing policy ↗ · the owners' names and logos line
```

- **The one page with search and filters**, by the owner's decision of 2026-10-10. §8.9's "no filter" rule still holds for the blog.
- One filter function serves the server render and the browser. Without JavaScript the form reloads the page with the query; with it, results follow each change and the address bar is replaced, never pushed. The canonical stays `/integrations`.
- Another language lists an entry only once its tagline there is translated from the current English summary. Each row links the English detail page with "(English)".
- No search and no filters while the registry is short; add them back past about twenty entries (owner, 2026-11-08).
- An entry sits under its first category the content file labels, in the registry's order. Official first, then by name, inside each band.
- Another language lists an entry only once its tagline there is translated from the current English summary. Each row links the English detail page with "(English)"; the name's link covers the row.

### 8.22 Integration page (`/integrations/{slug}`, English only)

Rebuilt 2026-11-08 on the feature-page grid.

```
Breadcrumbs Integrations / {name}
cols 1-8 mark 40 · H1 {name} · lead {summary} · By {publisher} · type Badge · Closed source · Archived
Hero Integrations / {name} · mark 40 · H1 {name} · lead {summary} · the description under it
Callout warning when archived · install action by type (button ↗, or a Homebrew CodeBlock) · Source code ↗
cols 9-12 Card "Details": Publisher · Category · Works with · TablePro app · License · Listed · Last checked
#about description paragraphs, as text
#screenshots CellGrid, 2 columns from 768
#uses "What it uses": TablePro features (docs ↗) · Reads · Changes · Callouts for lowered Safe Mode, internet, account, cost
#support Report a problem ↗ (registry issue form) · Get help from {publisher} ↗ · Documentation ↗ · Callout when not Official
#details term rows: Made by · Type · Category · Works with · TablePro app (Mac, Linux, iPhone & iPad, each with its version) · License · Listed · Last checked
#screenshots 2 columns from 640, only when the entry has them
#uses term rows: TablePro features (docs ↗) · Reads · Changes · Internet · Account · Price; the access note; a warning Callout only for a lowered Safe Mode
#support closing band: "Something wrong with this listing? Report it on GitHub." · Get help from {publisher} ↗ · Read the docs ↗ · the disclaimer when not Official
```

`/vi/integrations/{slug}` and the other languages answer 404 with a link to the English page.
- `#about` lands on `#details`.
- `/vi/integrations/{slug}` and the other languages answer 404 with a link to the English page.

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

Expand Down
2 changes: 2 additions & 0 deletions docs/rebuild/design/sitemap.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,8 @@ Column notes:
| `/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 | "A database client, built in the open." | Rebuilt 2026-11-08 on the feature-page grid, about 150 words (design-system §8.25): 1) Hero (`#top`): the statement H1 and one sentence naming the TablePro team (no person or city), the platforms and who pays; no actions, no image 2) Principles (`#principles`): Native, Open, Private, Independent, one word and one sentence each, no icons 3) Facts (`#facts`, old `#maker`, `#funding`, `#source`): term rows for Made by, Repository created, Source code, License, Funded by 4) Contact (`#contact`, old `#policies`, `#brand`): one sentence with the email and GitHub, live chat. Policies and Brand are in the footer | facts (links, repository date) | none | /pricing, /sponsors, GitHub, the license text | yes (all locales) |
| `/sponsors` | `/{locale}/sponsors` | Trust | "sponsor TablePro", "TablePro sponsors"; companies weighing a placement, readers checking who funds the app | "Sponsors" | Rebuilt 2026-11-08 on the feature-page grid, about 200 words (design-system §8.26): 1) Hero (`#top`): H1, one sentence (licenses and sponsors pay, no investors), Sponsor on GitHub ↗ and the open homepage places 2) One band per tier, dearest first (`#lead` with old `#tiers`, `#homepage` with old `#companies`, `#name` with old `#individuals`): the tier name and its monthly and one-time prices on the left, what it gets and that tier's sponsors on the right; logos sized by area at 1.5 times the homepage size from 640px; an empty tier says "Open." 3) Fine print (`#fine-print`): term rows for paying once, when a sponsorship ends, private sponsors, the logo file 4) Closing (`#sponsor`): one sentence with the email, Sponsor on GitHub ↗. No amount per sponsor, total or goal | sponsors.json (tiers, places, sponsors), facts (sponsors program, email) | none (sponsor logos are identity) | GitHub Sponsors, each sponsor's site | yes (all locales) |
| `/integrations` | `/{locale}/integrations` | Directory | "TablePro MCP", "TablePro Claude Code", "TablePro Raycast"; readers checking what connects to TablePro | "Integrations" | Rebuilt 2026-11-08 on the feature-page grid (design-system §8.21): 1) Hero (`#top`): H1, one sentence, Build an integration ↗ 2) One band per registry category (`#ai-clients`, `#command-line`, `#automation`, `#local-development`, …), ruled rows with the app's mark, name, tagline and maker 3) Closing (`#publish`): how to submit and the listing policy. No search or filters while the registry is short | integrations.json (synced from the TableProApp/integrations release) | none (marks are the registry's icons) | each `/integrations/{slug}` (English), docs `/developers` ↗, the registry on GitHub | yes (all locales) |
| `/integrations/{slug}` | none (English only; other locales 404 with an English suggestion) | Directory | "{name} TablePro", "connect {name} to a database" | "{name}" | Rebuilt 2026-11-08 (design-system §8.22): 1) Hero (`#top`, old `#about` lands on `#details`): breadcrumb, mark, H1, summary, description, install action, Source ↗ 2) `#details` term rows 3) `#screenshots` when present 4) `#uses` term rows, a warning only for a lowered Safe Mode 5) Closing (`#support`): report a problem, help, docs | integrations.json | none | /integrations, /features/data-editing#safe-mode, docs ↗ | yes while active; archived entries noindex |
| `/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
38 changes: 11 additions & 27 deletions resources/data/content/de/integrations/index.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,40 +5,19 @@
},
"header": {
"title": "Integrationen",
"lead": "Apps und Werkzeuge, die mit TablePro zusammenarbeiten.",
"lead": "Apps und Werkzeuge, die mit TablePro zusammenarbeiten, entwickelt vom TablePro-Team oder von anderen.",
"build": "Integration entwickeln"
},
"filters": {
"label": "Integrationen filtern",
"search": "Suchen",
"category": {
"label": "Kategorie",
"all": "Alle Kategorien"
},
"platform": {
"label": "TablePro-App",
"all": "Alle Apps"
},
"tier": {
"label": "Typ",
"all": "Alle Typen"
},
"submit": "Ergebnisse anzeigen",
"count": {
"one": "{count} Integration",
"other": "{count} Integrationen"
},
"empty": "Keine Integration passt zu diesen Filtern.",
"clear": "Filter zurücksetzen"
},
"publish": {
"title": "Deine Integration eintragen",
"sentence": "Du hast etwas gebaut, das mit TablePro zusammenarbeitet? Reiche es in der Registry auf GitHub ein.",
"guide": "Anleitung zum Einreichen",
"policy": "Aufnahmerichtlinie"
},
"notice": "Namen und Logos gehören ihren Inhabern. Nur offizielle Integrationen werden von TablePro entwickelt.",
"labels": {
"by": "Von {publisher}",
"byTier": "{tier}, von {publisher}",
"closedSource": "Nicht quelloffen",
"tiers": {
"official": "Offiziell",
Expand Down Expand Up @@ -72,7 +51,8 @@
"source": "Quellcode",
"details": {
"title": "Informationen",
"publisher": "Herausgeber",
"publisher": "Entwickelt von",
"tier": "Typ",
"category": "Kategorie",
"host": "Funktioniert mit",
"hostVersion": "{host} {version} oder neuer",
Expand All @@ -82,7 +62,6 @@
"added": "Aufgenommen",
"verified": "Zuletzt geprüft"
},
"about": "Beschreibung",
"screenshots": "Bildschirmfotos",
"uses": {
"title": "Was die Integration nutzt",
Expand Down Expand Up @@ -133,11 +112,16 @@
"payment": {
"optional": "Kostenlos, mit kostenpflichtigen Optionen",
"paid": "Kostenpflichtig"
},
"terms": {
"internet": "Internet",
"account": "Konto",
"payment": "Preis"
}
},
"support": {
"title": "Hilfe",
"report": "Problem mit diesem Eintrag melden",
"sentence": "Stimmt etwas mit diesem Eintrag nicht? <report>Melde es auf GitHub</report>.",
"help": "Hilfe bei {publisher} erhalten",
"docs": "Dokumentation lesen"
},
Expand Down
Loading