web-frontend
Develop and test the Vite React TypeScript SPA for the FinOps platform
SKILL.md.claude/skills/web-frontend/SKILL.md
GitHubWeb Frontend Development
Use this skill to:
- Start the development server
- Build components and pages
- Test UI functionality
- Manage state and data fetching
- Work with the Aeonik design system
Application Pages
The Vite React SPA includes:
- Understand — Overview, Trends, Spikes, Services, Tags
- Quantify — Unit Economics, KPIs
- Optimize — PR Projections, Commitments
- Manage — Assessments, Governance, Scopes, Settings
Tech Stack
- React 18+ with TypeScript
- Vite for fast dev/build
- Aeonik design system (teal brand theme)
- Azure AD OIDC authentication
- REST API integration
Common Tasks
Start Development Server
cd services/web
npm install
npm run dev
# Visit http://localhost:5173
Build for Production
npm run build
npm run preview
Run Web Tests
npm run test:web
npm run test:web:watch
Type Check
npm run type-check:web
Add New Page
- Create page component in
src/pages/ - Add route in
src/router.ts - Update navigation if needed
- Add authentication guards if required
Debug Authentication
Check browser console for Azure AD token issues and OIDC state.