frontend-dev-guidelines

Enforces opinionated React and TypeScript standards for Suspense-first frontend development.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/Eng-suso/BK-GPT --skill frontend-dev-guidelines-eng-suso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frontend-dev-guidelines
Source: https://github.com/Eng-suso/BK-GPT/tree/main/.claude/skills/frontend-dev-guidelines
Command: npx skills add https://github.com/Eng-suso/BK-GPT --skill frontend-dev-guidelines-eng-suso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Frontend codebases drift into inconsistent patterns—mixed loading states, scattered API calls, and untyped components—that slow development and cause performance regressions. This Skill enforces a single, strict set of architectural rules so every component, feature, and route follows the same production-grade conventions. ## Core Features & Use Cases - Suspense-First Data Fetching: Mandates useSuspenseQuery with SuspenseLoader boundaries, eliminating isLoading conditionals and layout shift. - Feature-Based Architecture: Defines canonical directory structure (api/, components/, hooks/, helpers/, types/) with import aliases and public index exports. - FFCI Feasibility Scoring: Provides a quantitative Frontend Feasibility & Complexity Index to evaluate whether a component should be built, simplified, or redesigned. - Use Case: When asked to build a new user profile page, the Skill produces a lazy-loaded route, a feature folder with an isolated API layer, a React.FC component using useSuspenseQuery, MUI v7 styling, and strict TypeScript—passing the operator validation checklist. ## Quick Start Use the frontend-dev-guidelines skill to create a new feature component for displaying a list of projects with data fetching and routing.

Frequently Asked Questions about frontend-dev-guidelines

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

FAQPage Schema
How do I fetch data in React without isLoading checks?▼

Use useSuspenseQuery from TanStack Query wrapped in a SuspenseLoader boundary. The data returned is always defined, so components never need isLoading conditionals or early-return spinners, which also prevents layout shift.

How should I structure a React feature folder?▼

Create a features/{name}/ directory with api/, components/, hooks/, helpers/, and types/ subdirectories, plus an index.ts for public exports. Keep API calls isolated in the api/ layer and forbid cross-feature imports.

What is the correct MUI v7 Grid syntax?▼

MUI v7 uses the size prop: <Grid size={{ xs: 12, md: 6 }} />. The older item and xs/md props directly on Grid are removed in v7 and must not be used.

When should I lazy load a React component?▼

Lazy load route components, feature entry points, and heavy UI like data grids, charts, editors, and large dialogs using React.lazy. Always wrap lazy components in a SuspenseLoader boundary.

Should I use useState, Zustand, or TanStack Query for state management?▼

Use TanStack Query for all server state, useState for local UI state like modals and tabs, and Zustand only for minimal global client state such as sidebar or theme preferences. Avoid prop drilling by using context or query cache.