brokle-frontend-dev

Guide Next.js/TypeScript frontend builds for Brokle's React app with defined patterns.

3|2|Updated Sep 4, 2025
One-click install
npx skills add https://github.com/brokle-ai/brokle --skill brokle-frontend-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brokle-frontend-dev
Source: https://github.com/brokle-ai/brokle/tree/main/.claude/skills/brokle-frontend-dev
Command: npx skills add https://github.com/brokle-ai/brokle --skill brokle-frontend-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides comprehensive guidance for Next.js/React frontend development, ensuring adherence to Brokle's feature-based architecture, best practices, and consistent code quality. It streamlines development and reduces technical debt.

Core Features & Use Cases

  • Feature-Based Architecture: Defines the standard directory structure and public API exports for self-contained features, promoting modularity.
  • State Management Strategy: Guides on using React Query for server state, Zustand for client state, and React Hook Form for form state.
  • Component Patterns: Explains when to use Server Components vs. Client Components and provides templates for components, hooks, and API clients.
  • Use Case: A frontend developer needs to build a new billing feature. This skill provides the exact structure for the feature, how to manage its state, interact with the API, and ensures all imports follow the mandatory feature index pattern.

Quick Start

I need to create a new notifications feature. Outline the directory structure, provide a component template, and explain how to manage its client-side state using Zustand.

Frequently Asked Questions about brokle-frontend-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a new feature in Next.js with Brokle's architecture?

Brokle's feature-based architecture organizes each feature in its own directory with a public API index file. Create a feature folder with subdirectories for components, hooks, API clients, and stores, then export public interfaces through an index file to enforce modular boundaries and prevent cross-feature imports.

What's the best way to manage state in a Next.js React application?

Use React Query for server state and API synchronization, Zustand for client state, and React Hook Form with Zod for form validation. This separation keeps server data fresh, client UI state predictable, and form logic testable across your Next.js application.

When should I use Server Components versus Client Components in Next.js?

Server Components handle data fetching and rendering on the server for performance and security; use Client Components only for interactive features requiring hooks, state, or event listeners. The Skill provides templates for both patterns within Next.js 15.5.2 App Router architecture.

How do I set up TypeScript with strict mode and Tailwind CSS in Next.js?

Enable TypeScript strict mode in tsconfig.json and configure Tailwind CSS 4.1.15 with the OKLCH-based design system and next-themes for dark mode support. This enforces type safety and ensures consistent styling aligned with Brokle's design guidelines.

Can I use shadcn/ui components with React Hook Form and Zod validation?

Yes. shadcn/ui components integrate seamlessly with React Hook Form for state management and Zod for schema validation. The Skill provides component templates and patterns for building validated forms across your Next.js application.

What testing tools work with Next.js and React components?

Vitest paired with React Testing Library and MSW (Mock Service Worker) provides unit, component, and API testing. This stack enables fast test execution, realistic component testing, and server request mocking without hitting live APIs during development.