Regeln: die festen Vorgaben
Im Repository committet, mit allen geteilt, geladen je nach Trigger. Store-Regeln gehören hierher, weil sie für jede künftige Änderung gelten müssen, nicht nur für die heutige Aufgabe.
Das Ziel: dieselbe Web-App, zwei native Apps
WebViewGold gibt dir ein natives Xcode-Projekt und ein Android-Studio-Projekt, deren Hauptbildschirm deine Produktions-URL in einer WKWebView oder Android WebView lädt, plus native Extras wie Push-Benachrichtigungen, einen Offline-Bildschirm und das Share Sheet. Dein Windsurf-Projekt bleibt die einzige Codebasis, und jeder Deploy erscheint in beiden Apps.
Die Aufgabe des Agenten ist, die Web-App als App durchs Review zu bringen: mobiles Layout, Rechtsseiten, Kontolöschung, keine Sackgassen und mindestens eine native Funktion, damit die App mehr ist als eine Website (Richtlinie 4.2). Die tool-spezifischen Grundlagen für diesen Stack stehen auf der Seite Windsurf in den App Store.
Eine Workspace-Regel, die jeden Agent-Lauf store-sicher hält
Speichere sie als .windsurf/rules/native-app.md, wenn du noch mit Cascade arbeitest (älteres Windsurf oder das JetBrains-Plugin), oder als .devin/rules/native-app.md in Devin Desktop. Beide nutzen dasselbe trigger-Front-Matter, und always_on lädt die Regel in jeder Session. Windsurf hat Regeldateien auf 12.000 Zeichen begrenzt, halte sie also schlank.
markdown
---
trigger: always_on
---
# Native app context
- This project is published as iOS and Android apps with WebViewGold, which loads
https://app.example.com in a native WebView. Every deploy is live in both apps.
- There is no separate mobile codebase. Do not propose React Native, Flutter or Capacitor.
- Detect the app with isNativeApp() in src/lib/platform.ts (user agent contains
"MyAppNative", set in WebViewGold). No other user agent checks.
- Native features are URL schemes (registerpush://, shareapp://message?=TEXT&url=URL,
bioauth://, qrcode://). Look up the exact syntax in
https://www.webviewgold.com/llms-full.txt, call them only inside the app,
and keep a web fallback.
# Never
- Use a preview or *.windsurf.build URL as the app URL.
- Open OAuth in popups or new windows (the Social Login Helper handles Google).
- Sell digital goods through Stripe links inside the iOS app.
- Ship placeholder text, "coming soon" buttons or dead links.
# Always
- /privacy, /terms and an in-app Delete account (server-side) exist and work.
- Sign in with Apple appears wherever Google or another social login appears.
- Layout works at 320 px; fixed bars pad env(safe-area-inset-top/bottom);
tap targets are at least 44 px.
- Loading, empty and error states for every fetch.
Großartige Arbeit! Ich habe noch nie etwas programmiert, aber ich konnte damit arbeiten. Einfach und schnell! Auch mit großartiger Hilfe von den Erstellern!
Den Readiness-Pass als Workflow oder Skill anlegen
Cascade-Workflows sind Markdown-Dateien in .windsurf/workflows/, die du mit einem Slash-Command startest, der nach der Datei benannt ist; Cascade führt nie von sich aus einen aus. In Devin Desktop werden dieselben Schritte zu einem Skill: ein Ordner .devin/skills/store-readiness/ mit dieser SKILL.md. Tippe /store-readiness, oder der Agent greift ihn auf, wenn deine Anfrage zur Beschreibung passt. Für einen Cascade-Workflow speicherst du die nummerierten Schritte als .windsurf/workflows/store-readiness.md, nur mit einer Beschreibung im Front Matter.
markdown
---
name: store-readiness
description: Audit and fix this web app for App Store and Google Play review before a WebViewGold build
---
1. Read the native-app rule. List the routes and the auth, payment and analytics code.
2. Mobile: open every main route in the Preview at 390 px and 320 px. Fix horizontal
overflow, tap targets under 44 px, inputs under 16 px font size and fixed bars
without safe-area padding.
3. Legal: make /privacy and /terms real (based on what the code collects) and link
them from the footer and the settings screen.
4. Accounts: if sign-up exists, add Delete account in settings (server-side deletion,
sign out, confirmation) and a public /delete-account page.
5. Sign-in: add Sign in with Apple next to any other social login.
6. States: loading, empty and error-with-retry for every fetch; a friendly 404.
7. App mode: hide store badges, install prompts and builder badges when isNativeApp().
8. Payments: list where digital goods are sold. Report only, change nothing.
9. Run lint, tests and build. Summarize the changes and what I must test on a phone.Regeln, Workflows, Memories, AGENTS.md: was wohin gehört
Workflows und Skills: die Abläufe
Wiederholbare mehrstufige Jobs wie dieser Readiness-Pass, eine Release-Checkliste oder die Triage einer Ablehnung. Du startest sie, wenn du sie brauchst.
Memories: persönliche Notizen
Cascade legt Memories von selbst an. Sie gehören zu dem Workspace, in dem sie entstanden sind, und bleiben auf deinem Rechner, Teamkollegen und andere Tools sehen sie also nie. Verlass dich bei einer Store-Regel nie auf eine Memory; bitte den Agenten, sie in eine Regel zu schreiben.
AGENTS.md: die toolübergreifende Datei
Devin Desktop liest AGENTS.md im Root und in Unterordnern als immer aktive Regeln, genau wie Cursor, Codex und GitHub Copilot. Wenn du Tools mischst, schreib den Abschnitt zur nativen App einmal dort hinein (Vergleich der Anweisungsdateien).
Vom Windsurf-Projekt bis zur Store-Einreichung
Die Reihenfolge funktioniert mit Cascade und mit Devin Local.
Regel und Skill hinzufügen
Committe beide Dateien. Starte eine neue Unterhaltung und bitte den Agenten, die Regeln zusammenzufassen, denen er folgt; die native-app-Regel sollte in der Antwort auftauchen.
Den Readiness-Pass ausführen
Tippe /store-readiness (oder in Cascade den Namen des Workflows). Prüfe jede Änderung im Diff, kontrolliere die Routen in der Preview und danach im Browser deines Handys.
Für die Produktion auf Netlify deployen
Die App Deploys von Cascade veröffentlichen unter einer Adresse
name.windsurf.build, sind für Vorschauen gedacht und schreiben einewindsurf_deployment.yamlmit den Projektdetails. Für die App übernimmst du die Site in dein eigenes Netlify-Konto oder verbindest das Git-Repository mit Netlify und fügst dann deine Domain hinzu (warum die Domain zählt). In Devin Desktop deployst du direkt mit Netlify, weil App Deploys für Devin Local nicht verfügbar sind.WebViewGold konfigurieren
Config.swift:
host,webviewurl,useragent_iphone,useragent_ipad. Config.java:HOST,HOME_URL,USER_AGENT. Setze die Trigger für den Social-Login-Helper, wenn du Google-Login nutzt, und wähle einen Push-Anbieter (OneSignal, Firebase oder Pushwoosh), wenn du Benachrichtigungen willst. Die Android-Setup-Doku listet jeden Schlüssel auf.Bauen
Mit einem Mac archivierst du in Xcode; in Android Studio baust du ein signiertes App Bundle. Willst du diesen Teil lieber abgeben, konfiguriert und baut dir das Full-Service-Team beide Apps innerhalb von 72 Stunden.
Einreichen und weiter iterieren
Lass den Agenten Datenschutzerklärung, Store-Beschreibung und Review-Notizen aus dem Code entwerfen; du reichst ein. Web-Änderungen gehen mit jedem Deploy live, und nur Änderungen an der nativen Hülle brauchen einen neuen Build.
Prompt: Produktions-Deploy plus Store-Pass
Nimm ihn, wenn du einen geführten Durchlauf dem Skill vorziehst, oder nur für den Deploy-Teil. Er stoppt nach dem Netlify-Setup, damit du zuerst den Build prüfen kannst.
In Cascade oder Devin Local einfügen
Wir veröffentlichen diese Web-App als native iOS- und Android-Apps mit WebViewGold, das unsere Produktions-URL in einer nativen WebView lädt. Halte dich an die native-app-Regel. Arbeite in dieser Reihenfolge und warte nach Schritt 2 auf meine Bestätigung. 1. Produktions-Build: Stelle sicher, dass "npm run build" aus einem sauberen Checkout funktioniert, und dokumentiere jede Umgebungsvariable in .env.example (nur Namen, keine Werte). 2. Netlify: Ergänze eine netlify.toml mit Build-Befehl und Publish-Verzeichnis für dieses Framework. Ist das eine Single-Page-App, ergänze einen Catch-all-Redirect auf /index.html mit Status 200, damit /privacy, /terms und /delete-account direkt laden. Liste die Umgebungsvariablen auf, die ich im Netlify-Dashboard eintragen muss. Nutze App Deploys nicht für die Produktion. 3. Nativer Helper: Ergänze src/lib/platform.ts mit isNativeApp(), das den User-Agent auf "MyAppNative" prüft. 4. Führe den Skill (oder Workflow) store-readiness aus und behebe, was er findet. 5. Schreibe docs/store/review-notes.md: was die App tut, einen Platzhalter für den Demo-Account und die nativen Features, die ein Reviewer ausprobieren kann. 6. Fasse alle Änderungen zusammen und gib mir einen Testplan fürs Handy: registrieren, mit Google und mit Apple anmelden, Konto löschen, Flugmodus, /privacy direkt öffnen.
Checkliste vor der Einreichung
- Die URL in Config.swift und Config.java ist deine eigene Domain auf Netlify, keine windsurf.build- oder Deploy-Preview-URL.
- Direkte Aufrufe von /privacy und /delete-account liefern die Seite, keinen 404.
- Der Agent kann dir die native-app-Regel in einer neuen Unterhaltung wiedergeben.
- Workflows, auf die du dich verlässt, gibt es als Skills, falls du zu Devin Desktop gewechselt bist.
- Im Flugmodus erscheint der WebViewGold-Offline-Bildschirm.
- Deine Produktionsdomain kommt ohne Warnungen durch den kostenlosen App-Store-Readiness-Check.
Stolperfallen
- Die windsurf.build-Preview ausliefern: Sie ist für Vorschauen gedacht, die Subdomain lässt sich nach dem Deployment nicht mehr ändern, und die URL wird in die App kompiliert.
- Single-Page-Apps auf Netlify ohne Catch-all-Redirect: Die Datenschutz-URL, die du in App Store Connect einträgst, liefert dem Reviewer einen 404.
- Memories als Regeln vertrauen: Sie wandern nicht zu Teamkollegen, in andere Workspaces oder in andere Tools.
- Alte
.windsurfrulesund neue.devin/rules, die sich widersprechen. Beide werden geladen, also führe sie zusammen. - Zwei globale Regeldateien: Gibt es sowohl
.devin/global_rules.mdals auch.windsurf/global_rules.md, wird nur die erste geladen. - Nur in der Preview des Editors testen. Die native WebView verhält sich bei OAuth, Datei-Uploads und Safe Areas anders; teste die gebaute App auf einem Handy.
Häufig gestellte Fragen
Wird Windsurf eingestellt?
Nein. Windsurf wurde im Juni 2026 in Devin Desktop umbenannt. Es ist derselbe Editor mit denselben Einstellungen und Erweiterungen, und das Windsurf-Plugin für JetBrains-IDEs gibt es weiterhin.
Kann ich Cascade noch nutzen?
In Devin Desktop starten neue Unterhaltungen mit Devin Local, und Cascade-Unterhaltungen lassen sich dort nicht mehr beginnen. Cascade bleibt im Windsurf-Plugin für JetBrains erhalten. Die Regel in diesem Guide funktioniert mit beiden Agenten; nutze einen Workflow mit Cascade und einen Skill mit Devin Local.
Funktionieren meine .windsurfrules noch?
Ja. Devin Desktop importiert .windsurfrules, .windsurf/rules/*.md und .windsurf/global_rules.md standardmäßig. Neue Regeln gehören nach .devin/rules/, das Vorrang hat, wenn beide existieren.
Kann ich die windsurf.build-URL in meiner App verwenden?
Laden würde sie, aber tu es nicht. App Deploys sind für Vorschauen gedacht, die Subdomain lässt sich später nicht ändern, und die URL wird in deine App kompiliert. Nimm deine eigene Domain auf Netlify oder einem anderen Host.
Brauche ich einen Mac?
Für einen manuellen iOS-Build in Xcode ja. Der WebViewGold Cloud Builder baut beide Apps im Browser und lädt sie hoch, und das Full-Service-Team kann Konfiguration und Build für dich übernehmen.
Drei Wege, deine App in die Stores zu bringen
Gleiches Ergebnis, unterschiedlich viel Arbeit auf deiner Seite. Alle drei kommen mit Genehmigungsgarantie und 24/7 Support von echten Menschen.
Selbst machen
$109 pro Plattform, einmalig
Die WebViewGold-Lizenz: ein fertiges Xcode- oder Android-Studio-Projekt. URL einfügen, Name und Icon setzen, Features einschalten, bauen und einreichen. Kostenlose Updates für immer.
Pakete auf der Hauptseite ansehenCloud Builder
$349 pro Lizenz, einmaliges Add-on
Kein Mac, kein Xcode, kein Android Studio: Du konfigurierst im Browser, wir bauen beide Apps in der Cloud und übergeben sie an App Store Connect und die Play Console.
So funktioniert der Cloud Builder Kostenlose Demo ausprobierenFull Service
$698 pro Plattform $798
Schick uns deine URL und dein Icon. Unser Team konfiguriert, baut und liefert deine App innerhalb von 72 Stunden, White-Label, inklusive Quellprojekten. Beide Plattformen für $1,158.
Full-Service-Details Powered by
Winter-Sale-Preise gültig bis 31. Dezember 2026.