React Frontend Golden Path Template

The recommended way to build React frontends at our organization.

What's Included

Category	Features
Core	Next.js 15, React 19, TypeScript 5.7, App Router
Styling	Tailwind CSS, shadcn/ui, CSS Modules, Styled Components
State	Zustand, Jotai, Redux Toolkit
Data	TanStack Query, SWR
Auth	Cognito, Auth0, NextAuth.js
Observability	Grafana Faro (RUM + Traces + Logs)
Testing	Vitest, Jest, Playwright, Cypress
DevEx	ESLint, Prettier, Husky, VS Code config

Quick Start

1. Go to Backstage Software Catalog
2. Select "React Frontend (Golden Path)"
3. Fill in the form
4. Click "Create"
5. Clone and start building

What You'll Get

your-frontend/
├── src/
│   ├── app/              # Next.js App Router
│   ├── components/       # React components
│   ├── hooks/            # Custom hooks
│   ├── lib/              # Utilities
│   └── providers/        # Context providers
├── k8s/                  # Kubernetes manifests
├── .github/              # CI/CD workflows
├── docs/                 # Documentation
├── Dockerfile            # Multi-stage build
├── Makefile              # Developer commands
└── README.md             # Service docs

Documentation

Document	Description
Decision Guide	How to choose template options
Golden Path Overview	What and why
Getting Started	First steps
Patterns Guide	Frontend patterns

Support

• Slack: #platform-help
• Office Hours: Thursdays 2-3pm

Version History

Version	Date	Changes
1.0.0	2025-12	Initial release

---

🤘 Platform Team