Recommended Tech Stack

About these recommendationsโ
This section documents Aliz's recommended tech stack for frontend projects. These are sensible defaults โ not mandates. Teams may deviate when there's a good reason, but starting here means less time debating tooling and more time shipping.
Recommendations are reviewed periodically by the Web Hub maintainers. Each page is a short introduction with rationale and links to official docs โ not a deep tutorial.
When to follow this stackโ
- New greenfield projects at Aliz
- When choosing between equivalent options and you need a tiebreaker
- When onboarding new team members and you want a consistent baseline
When to deviateโ
- Legacy projects already using a different stack โ don't rewrite for the sake of it
- Specific client requirements that dictate other choices
- Prototypes, throwaway scripts, or one-off experiments where setup cost matters more than long-term maintainability
What's coveredโ
Coreโ
- React โ UI library
- TypeScript โ type-safe JavaScript
- Astro โ content-focused web framework
Styling & UIโ
- Tailwind CSS โ utility-first CSS framework
- shadcn/ui โ component collection (Base UI/Radix + Tailwind)
- MUI โ Material UI component library
- Headless UI Components โ Radix UI & Base UI accessible unstyled primitives
State & Dataโ
- Zustand โ state management
- TanStack Query โ data fetching and server state
- i18next โ internationalization (i18n) framework
- Luxon โ date/time library (immutable API, built-in time zones and i18n)
- Zod โ TypeScript-first schema validation
Advanced / Situationalโ
- Redux Toolkit โ state + data fetching (default: Zustand + TanStack Query)
- React Hook Form โ form management (for complex/form-heavy apps โ simple forms don't need it)
Build & Devโ
- npm โ package manager
- Vite โ build tool and dev server
- ESLint โ linter
- Prettier โ code formatter
- Vitest โ testing framework
- Playwright โ end-to-end testing
- Storybook โ UI component development and documentation tool
- Workbox โ service worker tooling for offline & PWA support (optional)
- dotenv โ environment variable loading for local development and Node.js scripts
Monorepoโ
- Turborepo โ task orchestration and caching on top of npm workspaces
- syncpack โ consistent, pinned dependency versions across workspaces
Data Visualizationโ
- Recharts โ React charting library (default for dashboards)
- Apache ECharts โ enterprise-grade visualization (maps, 3D, big data)
Advanced / Situationalโ
- VisX โ low-level React viz primitives built on D3 (default: Recharts)
- D3.js โ foundational visualization toolkit (default: Recharts or Apache ECharts)
Backend Servicesโ
- Firebase โ Google's Backend-as-a-Service platform (Firestore, Auth, Hosting, Functions)
Securityโ
- DOMPurify โ XSS sanitizer for HTML content
Documentation Frameworksโ
- Docusaurus โ React-based documentation site generator (powers this Web Hub)
- Astro Starlight โ zero-JS documentation framework built on Astro
Deprecatedโ
- Webpack โ legacy bundler (use Vite)
- Bower โ abandoned package manager (use npm)
- Moment.js โ legacy date library (use Luxon)
- Create React App โ unmaintained React scaffolding (use Vite)
Discouragedโ
- Legacy Redux โ legacy state management patterns (default: Zustand; modern: Redux Toolkit)
- MobX โ reactive state management (default: Zustand)
- Angular โ full-featured framework (default: React)
- Vue โ progressive framework (default: React)
- Svelte โ compiler-based framework (default: React)
- Plain JavaScript โ untyped JS (default: TypeScript; fine for throwaway scripts)
- VitePress โ Vue-based doc site generator (default: Docusaurus or Astro Starlight)
Triageโ
- Triage โ libraries that need evaluation (niche or untested at Aliz)
This section will grow over time โ contributions welcome. If your team has settled on a tool that works well, open a PR.
For guidance on using AI tools and agents in your development workflow, see AI-Assisted Development.
For step-by-step project blueprints that show how these tools fit together in practice, see the Project Cookbooks โ recipes for React SPAs, Firebase apps, and documentation sites.