Vercel- Integration.
Die Vercel-Integration verbindet deinen Vercel-Account mit tokyn forge. Sie sorgt dafür, dass neue Frontend-Projekte automatisch mit einem Vercel-Projekt verknüpft werden und die Deployment-Pipeline ab dem ersten Push läuft.
Das Prinzip: tokyn forge deployt nie selbst
Deployments laufen ausschließlich über die CI deines Projekt-Repositories — nur auf dem main-Branch und nur nach bestandener Prüf-Pipeline (Lint, Dependency-Audit, Build). Die Auto-Deployments von Vercel sind in erzeugten Projekten bewusst deaktiviert (vercel.json), damit kein Weg an der Prüfung vorbeiführt. tokyn forge liest lediglich den Deploy-Status und zeigt ihn im Portal an.
Einrichtung
- In tokyn forge: Einstellungen → Tools → „Mit Vercel verbinden“
- Auf der Vercel-Seite den Account oder das Team wählen und die Installation bestätigen
- Zurück in tokyn forge erscheint die Verbindung automatisch als aktiv
- Neue Frontend-Projekte werden ab sofort provisioniert: Vercel-Projekt, Git-Verknüpfung und die CI-Secrets VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID im GitHub-Repo
Voraussetzung: Die Vercel-GitHub-App ist auf deinem GitHub-Account installiert, damit Vercel das Repository verknüpfen kann.
Berechtigungen und wofür wir sie nutzen
- Projects (Lesen/Schreiben): Vercel-Projekt anlegen und mit dem Git-Repo verknüpfen
- Deployments (Lesen/Schreiben): Status im Portal anzeigen; die CI deployt mit demselben Token
- Environment Variables (Lesen/Schreiben): „vercel pull“ in der CI lädt die Projektumgebung
- Current User / Teams (Lesen): Zuordnung von Account bzw. Team (VERCEL_ORG_ID)
Datenzugriff und Speicherung
tokyn forge speichert das Zugriffs-Token AES-256-verschlüsselt, getrennt je Workspace, sowie Team- und Projekt-IDs und Deployment-Metadaten (Status, URL, Zeitpunkt). Inhalte deiner Deployments werden nicht gelesen. Details in der Datenschutzerklärung.
Deinstallation
Trenne die Verbindung in tokyn forge (Einstellungen → Tools) — das Token wird sofort gelöscht — und deinstalliere die Integration in deinem Vercel-Dashboard unter Integrations. Bereits erzeugte Vercel-Projekte und Deployments bleiben unberührt.