adk-frontend

SKILL.md

ADK Frontend Integration

Use this skill when users ask questions about building frontend applications that connect to Botpress ADK bots. This covers authentication patterns, type-safe API calls, client configuration, and integrating generated types.

What is ADK Frontend Integration?

When you build a bot with the Botpress ADK, you often need a frontend application that interacts with it. This skill provides production-tested patterns for:

Authentication - Cookie-based PAT storage with OAuth flow

Client Management - Zustand store pattern for client caching and reuse

Type Generation - Using ADK-generated types for full type safety

Action Calls - Calling bot actions with proper error handling and optimistic updates

Key Technologies

@botpress/client - Official TypeScript client for Botpress API

Triple-slash references - TypeScript pattern for importing generated types

React Query - For mutations and cache management (optional but recommended)

Zustand - For client state management