frontend-dev-guidelines

Document React and TypeScript frontend guidelines with TanStack Query, Router, and MUI v7.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/danielctc/ReactSpacesMonoRepo --skill frontend-dev-guidelines-danielctc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontend-dev-guidelines
Source: https://github.com/danielctc/ReactSpacesMonoRepo/tree/main/.claude/skills/frontend-development
Command: npx skills add https://github.com/danielctc/ReactSpacesMonoRepo --skill frontend-dev-guidelines-danielctc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires .

What problem does it solve?

This Skill consolidates frontend development guidelines for React and TypeScript projects to ensure consistent architecture, maintainability, and performance across teams.

Core Features & Use Cases

  • Patterns for React components using React.FC<Props>, lazy loading, and Suspense boundaries.
  • Data fetching with TanStack Query using useSuspenseQuery and cache-first strategies.
  • File organization with a features directory structure (features/{feature}/api, components, hooks, helpers, types).
  • Routing with TanStack Router and per-route lazy loading.
  • Styling with MUI v7 using the sx prop and theme-aware styling.

Quick Start

Start by reviewing these frontend guidelines, then apply the patterns when building components, pages, or features. Create new components with React.FC, lazy-load heavy components, wrap them in a Suspense boundary, and fetch data with useSuspenseQuery. Use feature-based organization and the @/ and ~components aliases for clean imports.

Frequently Asked Questions about frontend-dev-guidelines

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

FAQPage Schema
What is the best way to structure a React and TypeScript project for maintainability?

The best way to structure a React and TypeScript project is using feature-based organization, grouping files into features/{feature}/api, components, hooks, helpers, and types directories to ensure consistent architecture and maintainability.

How do I implement Suspense-based loading with lazy loading in React?

To implement Suspense-based loading, create components using React.FC, lazy-load heavy components, and wrap them in a Suspense boundary to handle loading states gracefully while enforcing strict TypeScript usage.

Does TanStack Query support Suspense for data fetching?

Yes, TanStack Query supports Suspense for data fetching by utilizing the useSuspenseQuery hook alongside cache-first strategies to manage asynchronous data loading in React applications.

Can I use TanStack Router for per-route lazy loading in a frontend application?

Yes, you can use TanStack Router for per-route lazy loading, allowing you to split your route definitions and load route components dynamically to improve initial application performance.

What is the recommended approach for styling React components with MUI v7?

The recommended approach for styling React components with MUI v7 is using the sx prop and theme-aware styling to maintain visual consistency and leverage the theme configuration across the application.

Why should I use alias imports in a TypeScript project?

You should use alias imports like @/ and ~components in a TypeScript project to establish clean imports, avoid deeply nested relative paths, and simplify file referencing across feature directories.