AgentSkillsCN

frontend-tech-stack

为前端应用技术栈提供标准化规范。在搭建新前端项目,或使用 React 19、Vite 与 Tailwind v4 升级现有项目时,应优先选用此技能。

SKILL.md
--- frontmatter
name: frontend-tech-stack
description: Provides standards for the frontend application technology stack. This skill should be used when setting up new frontend projects or upgrading existing ones with React 19, Vite, and Tailwind v4.

Frontend Tech Stack

This skill defines the standard technology stack for all frontend applications (erify_creators, erify_studios, etc.) in the project.

Core Core Technologies

CategoryTechnologyVersionNotes
FrameworkReact19.xUse functional components and hooks.
Build ToolVite6.xFast HMR, uses @vitejs/plugin-react.
StylingTailwind CSS4.xUse the @tailwindcss/vite plugin.
RoutingTanStack Router1.xFile-based routing, type-safe navigation.
State/QueryTanStack Query5.xFor async server state management.
I18nParaglide JS2.xType-safe internationalization.

Project Structure

Frontend apps should follow this structure:

code
src/
├── routes/             # TanStack Router file-based routes
│   ├── __root.tsx      # Root layout
│   ├── index.tsx       # Homepage
│   └── feature.tsx     # Feature route
├── components/         # App-specific components
├── hooks/              # App-specific hooks
├── lib/                # Utilities and API clients
├── main.tsx            # Entry point
└── index.css           # Global styles (Tailwind imports)

Configuration

Vite Config ("vite.config.ts")

Ensures Tailwind v4 and TanStack Router integration:

typescript
import tailwindcss from '@tailwindcss/vite';
import { tanstackRouter } from '@tanstack/router-plugin/vite';
import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    tanstackRouter(),
    react(),
    tailwindcss(),
  ],
});

Tailwind Config (v4)

Tailwind v4 uses CSS-first configuration. Your index.css should look like:

css
@import "tailwindcss";

@theme {
  --font-sans: "Inter", sans-serif;
  /* Define custom tokens here */
}

Checklist

  • Project is initialized with Vite + React + TypeScript.
  • Uses Tailwind CSS v4 plugin.
  • Uses TanStack Router for navigation.
  • Depends on workspace packages (@eridu/ui, @eridu/api-types) where appropriate.