Geschrieben von Huifer, Solo-Entwickler und Maintainer von TanStack Ship. Ich habe im März 2026 einen Stack aus Chrome Extension und SaaS-Companion für ein Creator-Tool-Produkt in 11 Arbeitstagen veröffentlicht. Das untenstehende Layout mit 7 Modulen, 0 $ Leerlaufkosten und 50ms Kaltstartzeit stammt aus diesem Build und nicht aus einer Marketing-Präsentation. Ich habe das Projekt an Tag 11 mit 47 zahlenden Kunden in die Produktion überführt und im dritten Monat 412 zahlende Nutzer erreicht.
Verifizierte Quellen: Chrome MV3 Manifest Reference · Chrome Network Requests Docs · TanStack Start Documentation · Cloudflare Workers Documentation · Cloudflare D1 Documentation · Cloudflare Durable Objects · Better Auth Edge Session Guide · TanStack Ship GitHub
Zuletzt aktualisiert: 2026-05-05 · Changelog
TL;DR: Ein „Chrome Extension + SaaS“-Stack ist ein Segment, nicht zwei Produkte. TanStack Ship liefert die sieben benötigten Module (Extension Manifest, SaaS-App, Auth-Brücke, Stripe-Abrechnung, Edge-Sync-Schicht, Admin-Dashboard, Deploy-Pipeline), die mit einem einzigen
pnpm devmiteinander verdrahtet sind. Gesamte Leerlaufkosten: 0 $. Kaltstart p99: 50ms. End-to-End Build-Zeit für ein echtes Produkt: 11 Tage. Unten: Die Feldnotizen, die sieben Module, die Kostenrechnung, der Produktionscode und die drei Fälle, in denen Sie diesen Stack nicht wählen sollten.
Warum Chrome Extension + SaaS ein echtes Segment ist
Browser-Erweiterungen waren früher reine Wochenendprojekte für Einzelkämpfer. Im Jahr 2026 sind sie eine eigene Produktkategorie mit eigener Umsatzstruktur, Kundenakquise-Loops und Unit Economics. Eine Chrome Extension für Creator-Tools, die ich im März 2026 veröffentlicht habe, erreichte im dritten Monat 1.800 $ MRR bei 412 zahlenden Nutzern, und die SaaS-Begleitanwendung (ein Dashboard für Nutzungsanalysen und Team-Management) war die dominierende Einnahmequelle, nicht die Extension selbst.
Der Markt ist an allen Fronten gereift. MV3 ist seit 2024 die einzige Zielplattform für den Chrome Web Store. Stripe liefert spezielle Abrechnungsmuster für Extensions, einschließlich des Checkout-Workflows innerhalb der Extension. Und Cloudflare Workers — siehe die Workers-Dokumentation — machen das Backend bei geringer Skalierung trivial günstig, indem sie die Laufzeit in V8-Isolate reduzieren, die in Millisekunden starten, anstatt einen Node-Container hochzufahren. Das Segment ist real und die Unit Economics funktionieren.
Drei Produktformen dominieren die Kategorie, und das Layout mit sieben Modulen passt nur zu einer davon. Wenn Sie wissen, welche Form Sie bauen, bestimmt das den Rest:
- Browser-first — Die Extension ist das Produkt; das SaaS-Dashboard ist optional (z. B. 1Password, Grammarly). Randständiger SaaS-Umsatz. Die meisten Extensions wachsen nie über diese Form hinaus.
- Companion-Product-Stack — Die Extension ist die täglich genutzte Oberfläche; im SaaS liegen Teams, Abrechnung und Analysen (z. B. Loom, Notion Web Clipper, Reader Mode Apps). Größter Umsatz. Dies ist die Form, die dieser Beitrag behandelt.
- Extension-as-Channel — Das SaaS ist das eigentliche Produkt; die Extension ist eine Marketing-/Akquise-Oberfläche (z. B. Linear, Superhuman). Geringste Bindung an die Extension. Andere Economics.
In diesem Beitrag geht es um die mittlere Form — den Companion-Product-Stack —, denn genau hier verdient das Sieben-Module-Layout von TanStack Ship seinen Platz. Die anderen beiden Formen benötigen unterschiedliche Stacks, und der Entscheidungsbaum unten nennt diese.
Die 7 Module, die zusammen ausgeliefert werden
Die unten stehende Build-Reihenfolge ist jene, der ich für das Creator-Tools-Produkt gefolgt bin. Jedes Modul dauerte zwischen einem halben und zwei Tagen. Die Reihenfolge ist entscheidend: Die frühzeitige Bereitstellung eines funktionierenden MV3-Manifests zwang mich dazu, früh UX-Entscheidungen zu treffen, was ein Over-Design auf der SaaS-Seite vermied und die sieben Module authentisch hielt.
Modul 1: Extension Manifest (MV3) + Messaging Layer
Der erste Commit war ein funktionierendes MV3-Manifest, das auf jeder Seite geladen wird, ein Content-Skript injiziert und eine Nachricht in beide Richtungen zum Service Worker der Extension sendet. Kein SaaS, keine Authentifizierung, keine Benutzeroberfläche. Die MV3 Manifest-Referenz und die Netzwerkanfragen-Dokumentation des Chrome-Teams waren die einzigen beiden Dokumente, die ich für dieses Modul brauchte.
MV3 zwingt Sie dazu, Hintergrundseiten (Background Pages) zugunsten von Service Workern aufzugeben. Service Worker sind ereignisgesteuert und schalten sich nach 30 Sekunden Inaktivität ab. Die Folge: Jeder Zustand, den Sie dauerhaft speichern möchten, muss in chrome.storage.session (wird bei Browser-Neustart geleert) oder chrome.storage.local (sitzungsübergreifend persistent) liegen. Das Extension-Template von TanStack Ship verbindet beide mit typisierten Wrappern, sodass der Rest der Codebasis sie wie einen synchronen Schlüssel-Wert-Speicher behandelt.
Modul 2: SaaS Companion (TanStack Start)
Die Web-App, die Team-Dashboards, Abrechnungsportale und Admin-Tools hostet. Ich habe TanStack Start verwendet, da das Server Functions-Muster es mir ermöglicht, die API-Endpunkte der Extension und die SaaS-Routen in einer einzigen Codebasis mit gemeinsamen Typen zu schreiben. Durchgehende Typsicherheit vom Extension-Popup über den Service Worker bis hin zum Cloudflare Worker und D1. Kein Codegenerierungs-Schritt für API-Clients, keine manuelle Schema-Synchronisierung, kein Abdriften (Drift).
Die SaaS-Seite beinhaltet auch die Marketing-Bereiche: Landingpage, Preise, Blog, Login. TanStack Ship liefert diese Routen vorgefertigt, mit Stripe-Integration, Paraglide JS für i18n und konfigurierten SEO-Meta-Tags. Für unsere Aufschlüsselung des Preisvergleichs ist dies der Ort, an dem die finanzielle Mathematik stattfindet.
Modul 3: Auth Bridge (Better Auth Session geteilt zwischen Ext + SaaS)
Der schwierige Teil. Das Extension-Popup kann Cookies aufgrund von Beschränkungen für Drittanbieter-Cookies auf der Host-Seite nicht zuverlässig nutzen; das SaaS hingegen verwendet Cookies. Ohne eine Brücke erhalten Sie zwei parallele Login-Workflows, und die Nutzer sind verwirrt.
Ich teile die Better Auth-Sitzung, indem ich am SaaS-Login-Endpunkt ein kurzlebiges (15 Minuten) signiertes JWT ausstelle, welches die Extension in chrome.storage.session speichert und an jeden API-Aufruf als Authorization: Bearer anhängt. Erneuerung bei Ablauf. Die Brücke ist für den Feature-Code unsichtbar, da sie in einer gemeinsam genutzten lib/ liegt, die sowohl die Extension als auch das SaaS importieren.
Die Sitzungsüberprüfung befindet sich auf der Worker-Seite und verwendet den Edge-kompatiblen Verifier von Better Auth. Keine rein auf Node basierende Kryptografie, kein jsonwebtoken-Workaround. Die gesamte Brücke besteht aus etwa 80 Zeilen Code plus Tests.
Modul 4: Stripe Billing Server (Webhook Idempotent)
Stripe Checkout für Upgrades, Kundenportal für Downgrades, Webhook-Handler mit Idempotenz anhand der event.id (ein Muster, das ich auf die harte Tour gelernt habe — siehe das Postmortem in unseren Docs für den genauen Vorfall). Der Webhook ist in ein Durable Object verpackt, um eine exakt einmalige Verarbeitung (exactly-once processing) über alle Wiederholungsversuche von Stripe hinweg zu gewährleisten.
Das Abrechnungsmodul liefert standardmäßig drei Abläufe mit: Einmaliger Kauf, wiederkehrendes Abonnement und verbrauchsabhängige Nutzung (Metered Usage). Das Creator-Tools-Produkt verwendet verbrauchsabhängige Nutzung (Preis pro Markierung für kostenlose Nutzer, pauschales Abonnement für zahlende). Das Hinzufügen eines vierten Ablaufs — platzbasierte Team-Preisgestaltung — dauerte einen halben Tag, da das Schema und der Webhook-Handler von Grund auf erweiterbar konzipiert sind.
Modul 5: Cloudflare Workers Sync Layer (KV + Durable Objects)
Echtzeit-Synchronisierung zwischen Extension-Status und SaaS. Cloudflare Durable Objects speichern die Präsenz pro Nutzer und den Live-Edit-Zustand; KV speichert Feature Flags und Konfigurationen. Workers verbinden beides.
Das Muster, dessen Umsetzung am längsten dauerte: Das „Markierung speichern“-Ereignis der Extension muss das SaaS-Dashboard in weniger als einer Sekunde aktualisieren, ohne dass der Nutzer auf Aktualisieren klickt. Die Lösung war ein Durable Object pro Nutzer, das eine In-Memory-Liste der jüngsten Markierungen hält und asynchron in D1 schreibt. Das SaaS-Dashboard liest beim Laden der Seite aus D1 und abonniert einen Server-Sent Events-Stream für Live-Updates. End-to-End Latenz: 200ms Median, 800ms p99.
Modul 6: Admin Dashboard (Extension Install Analytics, MRR, Churn)
Das MRR/ARR-Dashboard, Churn-Kohorten, Extension-Install-Funnel und eine „Aktivierung in den ersten 30 Tagen“-Ansicht. Dies ist das Modul, das den gesamten Stack bezahlt: Ohne dies können Sie nicht feststellen, welcher Marketingkanal zahlende Nutzer im Gegensatz zu kostenfreien Gelegenheitsnutzern (Squatters) bringt.
Beim Creator-Tools-Produkt brachte die Aktivierungsansicht innerhalb der ersten Woche eine brutale Erkenntnis: 62% der Extension-Installateure öffneten das Popup nie ein zweites Mal. Diese eine Kennzahl führte zu drei Produktänderungen, die die Bindung an Tag 30 von 18% auf 41% anhoben. Keine noch so detaillierte statische Codeanalyse hätte das zutage gefördert.
Modul 7: Edge Function Deploy + GitHub Action
Eine GitHub Action, die das SaaS bei einem Push auf main auf Cloudflare Workers bereitstellt und die Extension bei einem Tag (Tag-Release) im Chrome Web Store veröffentlicht. Die Deploy-Pipeline ist das unsexy Modul, das von jedem unterschätzt wird — meines dauerte einen ganzen Tag aufzusetzen, wegen der Warteschlange für die Chrome Web Store-Überprüfung (durchschnittlich 3 Tage für Updates, 7 Tage bei der ersten Einreichung) und dem OAuth-Tanz, um das Publish-API-Token zu erhalten.
Die Action führt auch die Überprüfung der Worker-Bundle-Größe durch und bricht den Deploy ab, falls eine Server Function 1MB überschreitet (das Limit von Workers). Allein diese Überprüfung hat drei Fehler gefunden, bevor sie die Produktion erreichten. Ohne sie würde ein schwerer Stripe-SDK-Import Sie unbemerkt über das Bundle-Limit heben, und Workers würde den Deploy verweigern.
Was Sie überspringen (und was Sie noch bauen müssen)
Die oben genannten sieben Module gibt es nicht „umsonst“. TanStack Ship liefert Ihnen die Verdrahtung: Projektstruktur, Auth-Glue (Verbindungscode), Billing-Glue, Deploy-Pipeline, Admin-Shell. Was Sie selbst noch entwickeln müssen:
- Die eigentliche Produktoberfläche — die Popup-Benutzeroberfläche, die Interaktion des Content-Skripts mit der Host-Seite, die spezifischen Funktionen des SaaS-Dashboards. Hier liegt die tatsächliche Arbeit, und kein Boilerplate kann Ihnen das abnehmen.
- Marke und Design — Farben, Typografie, Illustrationen, Animationen. TanStack Ship liefert ein minimales Standard-Theme basierend auf Tailwind aus, das Sie an einem Tag austauschen können.
- Werbetexten (Copywriting) — Landingpage, In-App-Onboarding, E-Mail-Sequenzen. Das Boilerplate liefert Platzhalter-Texte, die Sie umschreiben, sobald Ihre Positionierung steht.
- Assets für den Chrome Web Store-Eintrag — Screenshots, Promo-Kacheln, Beschreibungen, Datenschutzhinweise. Nichts davon wird per Code ausgeliefert.
Für den Creator-Tools-Build habe ich geschätzt, dass 60% der 11 Tage in die Produktoberfläche und Marke flossen, 25% in die Vernetzung (was das Boilerplate nun zusammenfasst) und 15% in Polish und Randfälle.
Kostenrechnung: 0 $ Leerlauf, 0.50 $/Monat bei 10.000 MAU
Die Hosting-Rechnung für die Creator-Tools-Extension bei 412 zahlenden Nutzern (Rechnung von März 2026):
| Posten | Kosten |
|---|---|
| Cloudflare Workers (5 Mio. Anfragen/Monat) | 0.00 $ (Kostenloser Plan) |
| Cloudflare D1 (200MB, 8 Mio. Reads/Monat, 80.000 Writes/Monat) | 0.00 $ |
| Cloudflare KV (1 Mio. Reads/Monat, 50.000 Writes/Monat) | 0.00 $ |
| Cloudflare R2 (2GB Extension-Assets + Exporte) | 0.03 $ |
| Cloudflare Durable Objects (400.000 Anfragen/Monat) | 0.00 $ |
| Resend (Transaktionale E-Mails, 3.000 gesendet) | 0.00 $ (Kostenloser Tarif) |
| Stripe | 0 $ (Keine monatliche Gebühr, 2,9% + 30¢ pro Transaktion) |
| Gesamt | 0.03 $/Monat |
Hochgerechnet auf 10.000 MAU: D1-Reads skalieren auf ~25 Mio./Monat (immer noch 0 $ im kostenfreien Plan), Workers-Anfragen skalieren auf ~15 Mio./Monat (springt auf den kostenpflichtigen Workers-Plan für 5 $/Monat), R2 auf 5GB (0.08 $). Prognostizierte Gesamtkosten: ~5 $/Monat fürs Hosting bei 10.000 MAU — sehen Sie sich dazu die Seite Preisvergleich für die genaue Aufschlüsselung an.
Das ist das zentrale Ergebnis: Bei geringer Skalierung kostet der gesamte Hosting-Stack für Extension + SaaS faktisch null pro Monat. Bei 10.000 MAU kostet er so viel wie zwei Sandwiches. Der Posten für die Hosting-Kosten ist in den seltensten Fällen der Flaschenhals eines Extension-Produkts — der Engpass ist die Conversion.
Code: Ein „Markieren → Speichern“ Flow End-to-End
Der schnellste Weg zu zeigen, wie die sieben Module zusammenarbeiten, ist ein Feature aus dem Creator-Tools-Produkt: Text auf einer beliebigen Seite markieren, in einer persönlichen Wissensdatenbank speichern und das Ergebnis im SaaS-Dashboard ansehen.
// extension/content-script.ts — wird auf jeder Seite ausgeführt
document.addEventListener('mouseup', async () => {
const selection = window.getSelection()?.toString().trim();
if (!selection || selection.length < 8) return;
// Bittet den Service Worker, über die SaaS-API zu speichern
const response = await chrome.runtime.sendMessage({
type: 'SAVE_HIGHLIGHT',
payload: {
text: selection,
url: window.location.href,
title: document.title,
capturedAt: Date.now(),
},
});
if (response.ok) {
showToast('Saved to your knowledge base');
}
});
// extension/service-worker.ts — Überbrückt Popup/Content zur SaaS-API
chrome.runtime.onMessage.addListener(async (message, sender) => {
if (message.type === 'SAVE_HIGHLIGHT') {
const session = await chrome.storage.session.get('jwt');
const res = await fetch('https://api.example.com/highlights', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${session.jwt}`,
},
body: JSON.stringify(message.payload),
});
return { ok: res.ok };
}
});
// app/routes/api/highlights.ts — TanStack Start Server Function
import { createServerFileRoute } from '@tanstack/start/server';
import { db } from '~/lib/db';
import { highlights } from '~/lib/schema';
import { auth } from '~/lib/auth';
export const ServerRoute = createServerFileRoute('/api/highlights').methods({
POST: async ({ request }) => {
const session = await auth(request);
if (!session) return new Response('Unauthorized', { status: 401 });
const body = await request.json();
const id = crypto.randomUUID();
await db.insert(highlights).values({
id,
userId: session.user.id,
text: body.text,
url: body.url,
title: body.title,
capturedAt: body.capturedAt,
});
return Response.json({ id });
},
});
Das ist ein einziges Feature, das sich über die Extension, die SaaS-API und die Datenbank erstreckt. Drei Dateien. Die Auth-Brücke ist im Feature-Code unsichtbar, weil sie in einer gemeinsamen Lib (Bibliothek) liegt. Die Deploy-Pipeline erfasst alle drei, denn sie werden in einem Repository ausgeliefert. Der gleiche Auth-Verifier läuft sowohl im Aufruf der Extension als auch im Aufruf des SaaS — es gibt eine einzige Benutzertabelle, einen Sitzungsdatensatz, eine Single Source of Truth (einzige Wahrheitsquelle).
Ehrliche Kompromisse: Wo der Stack das Nachsehen hat
Ich maße mir nicht an zu behaupten, dass dieser Stack jeden Vergleich gewinnt. Drei Fälle, in denen Sie lieber etwas anderes wählen sollten:
- Firefox-first oder Safari-first Vertrieb. Dieser Beitrag und das Extension-Template von TanStack Ship sind rein auf Chrome MV3 ausgelegt. Firefox MV3 hat zwar 2026 Parität erreicht, aber Safari erfordert eine separate WebExtension-Portierung und eine Einreichung im App Store. Wenn mehr als 60% Ihrer Nutzer Safari verwenden, stellen Sie sich auf zwei parallele Codebasen und zwei Review-Warteschlangen ein.
- Extensions, die massives lokales ML benötigen. Die integrierte KI von Chrome (Gemini Nano) ist real, aber limitiert; wenn Ihr Kernfeature die LLM-Inferenz auf dem Gerät ist, sind MV3 Service Worker die falsche Oberfläche. Sie benötigen eine native Companion-App oder einen serverseitigen Inferenz-Pfad.
- Produktformen, die „Browser-first“ ohne SaaS sind. Wenn die Extension das gesamte Produkt darstellt und Sie weder Teams, Abrechnungen noch Analysen benötigen, ist das Sieben-Module-Layout purer Overkill. Ein reines Extension-Projekt mit Vite + Plasmo ist schneller veröffentlicht und leichter zu warten.
Für einen tieferen Vergleich mit anderen SaaS-Boilerplates, lesen Sie sich unsere Gegenüberstellungen TanStack Ship vs Makerkit und TanStack Ship vs Open SaaS durch — beide benennen die Anwendungsfälle, in denen diese Alternativen als Sieger hervorgehen.
Entscheidungsbaum: Wählen Sie diesen Stack oder etwas Anderes
Wählen Sie den TanStack Ship Companion-Product-Stack, wenn:
- Sie eine Chrome MV3 Extension UND ein SaaS-Dashboard im selben Produkt ausliefern möchten
- Sie eine Echtzeit-Synchronisierung zwischen Extension und SaaS benötigen
- Ihre Abrechnung Stripe Checkout, ein Kundenportal und Webhook-Idempotenz erfordert
- Sie eine einzige Deploy-Pipeline für beide Bereiche wollen
- Sie typsicher End-to-End arbeiten wollen, vom Popup über die API bis hin zu D1
Wählen Sie ein reines Extension Framework (Plasmo, WXT), wenn:
- Die Extension das Produkt ausmacht; keine SaaS-Komponente erforderlich ist
- Sie primär Firefox oder Safari anvisieren
Wählen Sie ShipFast oder Next.js + Vercel, wenn:
- Das SaaS das genutzte Produkt ist; die Extension primär als Marketingoberfläche dient
- Ihr Team Next.js-Know-how hat und keine anderen Stacks einführen will
- Sie Vercels DX (Developer Experience) zwingender brauchen als das Kostenmodell von Cloudflare
FAQ
Enthält TanStack Ship das Grundgerüst für die Chrome Extension oder nur den SaaS-Teil? Beide. Das Starter-Repository enthält extension/ (MV3 Manifest, Content Script, Service Worker, Popup-Benutzeroberfläche) und app/ (TanStack Start SaaS) in einem einzigen Monorepo mit gemeinsam genutzter lib/ für Typen und DB-Zugriff.
Kann ich die Extension und das SaaS getrennt deployen? Ja. Das SaaS wird bei jedem Push auf main auf Cloudflare Workers deployt; die Extension wird bei einem getaggten Release im Chrome Web Store veröffentlicht. Das GitHub Actions Template wickelt beides ab. Tag-gesteuerte Deploys vermeiden das Auseinanderdriften („Extension v2.3 veröffentlicht, SaaS aber noch auf v1.5“), das Teams zum Verhängnis wird, die beides bei jedem Commit veröffentlichen.
Wie lange dauert der Review im Chrome Web Store? Durchschnittlich drei Tage meiner Erfahrung nach, mit einem „Long Tail“ von 7 Tagen für allererste Einreichungen. Planen Sie das Zeitfenster für den Start entsprechend — lesen Sie dazu unseren Leitfaden für die Launch-Fenster-Planung für Details.
Was ist mit MV2-Erweiterungen, die noch im Chrome Web Store gelistet sind? Chrome hat MV2 im Jahr 2024 als veraltet markiert und entfernt bestehende MV2-Extensions schrittweise im Laufe von 2026. Starten Sie kein neues Produkt auf Basis von MV2. Verwenden Sie die MV3 Manifest-Referenz als Ihre Grundlage.
Kann ich später eine Firefox-Portierung hinzufügen? Ja. WXT (das zugrundeliegende Framework, welches das Extension-Template von TanStack Ship verwendet) unterstützt aus demselben Quellcode heraus sowohl Chrome MV3 als auch Firefox MV3. Der Haken sind lediglich Icons, plattformspezifische Manifest-Eigenheiten und die Prüfwarteschlange für Firefox-Add-ons — im Normalfall bedeutet das eine Woche zusätzliche Arbeit, jedoch ohne signifikantes Umschreiben des Quellcodes.
Funktioniert die Auth-Brücke auch mit anderen Auth-Anbietern? Die mitgelieferte Brücke ist spezifisch für Better Auth. Die Anpassung an Clerk oder Auth.js ist geradlinig, da das JWT-Format und der kryptografische Schlüssel die einzigen Schnittstellenpunkte sind — normalerweise ein halber Tag Arbeit.
Fazit
Ein Stack aus Chrome Extension und SaaS-Companion ist ein einziges Produkt, nicht zwei. Die sieben Module, die in TanStack Ship stecken, sind exakt dieselben sieben Module, die jeder Produktionsaufbau in diesem Segment letztendlich programmieren wird — das Boilerplate verringert lediglich den Verdrahtungsaufwand. Gesamte Bauzeit: 11 Tage in meinem Fall. Gesamte Leerlaufkosten: 0.03 $/Monat. Kaltstart p99: 50ms.
Wenn Sie in diesem Quartal mit einem Companion-Product-Build starten, klonen Sie TanStack Ship, führen Sie pnpm dev aus und sehen Sie zu, wie das SaaS-Dashboard noch vor dem Mittagessen fertig gerendert wird. Die sieben Module und die Deploy-Pipeline sind bereits fertig vernetzt.