Skip to Content
AppSDKInstallation

Installation

Voraussetzungen

  • Node.js >= 24
  • Next.js >= 15
  • React >= 19

Falls noch kein Projekt vorhanden ist:

npx create-next-app@latest my-processcube-app
cd my-processcube-app

Paket installieren

npm install @5minds/processcube_app_sdk@latest

Next.js konfigurieren

Die einfachste Konfiguration mit dem SDK-Plugin:

next.config.ts
import { withApplicationSdk } from '@5minds/processcube_app_sdk/server';
 
export default withApplicationSdk({
  applicationSdk: {
    useExternalTasks: true,
  },
});

Ohne External Tasks reicht:

next.config.ts
import type { NextConfig } from 'next';
 
const nextConfig: NextConfig = {
  serverExternalPackages: ['esbuild'],
};
 
export default nextConfig;

Die serverExternalPackages-Konfiguration ist erforderlich, damit das SDK korrekt mit Next.js Server Components funktioniert.

CSS einbinden

Komponenten-CSS wird automatisch geladen — beim Import einer Client-Komponente wird das zugehörige Stylesheet vom Consumer-Bundler (webpack/turbopack) mit aufgelöst. Ein manueller CSS-Import ist nicht nötig.

Falls die Tailwind-Basisstyles (Resets, Utilities) separat benötigt werden:

// app/layout.tsx
import '@5minds/processcube_app_sdk/client/styles';

Umgebungsvariablen

Erstelle eine .env.local im Projekt-Root:

.env.local
# Pflicht
PROCESSCUBE_ENGINE_URL=http://localhost:10560
 
# Für Authentifizierung (optional)
PROCESSCUBE_AUTHORITY_URL=http://localhost:11560
NEXTAUTH_CLIENT_ID=my_client_id
NEXTAUTH_SECRET=my_secret

Wenn die Engine auf dem Standard-Port 10560 läuft, kann PROCESSCUBE_ENGINE_URL weggelassen werden.

Die vollständige Liste aller Umgebungsvariablen findest du unter Konfiguration → Environment Variables.

Nächste Schritte

ÜbersichtErste Schritte