Skip to content

STD-TEC-001: Technology Stack (The Arsenal)

1. Context

To maintain a consolidated "Canonical" stack and prevent technology sprawl. Alternatives are forbidden without an ADR.

2. The Standard (The Floor)

  • [MUST] Framework: Next.js 14+ (App Router, Server Actions).
  • [MUST] Runtime: Node.js 18+ (Alpine).
  • [MUST] UI Primitives: Radix UI (Headless), Tailwind CSS (Styling), Lucide React (Icons).
  • [MUST] Enterprise UI: Syncfusion Essential Studio (Grids, Charts, Document Processing). License validation mandatory.
  • [MUST] Database: Firestore (NoSQL).
  • [MUST] Secrets: Doppler.

3. Best Practices (The Path)

  • [SHOULD] Communications: Access providers via CommunicationsHub (Twilio, Resend).
  • [SHOULD] Forms: Use React Hook Form + Zod.
  • [SHOULD] Animations: Framer Motion for non-critical UI transitions.

4. The Adoption Matrix

This table defines the Authorized Software Bill of Materials. Use of anything marked "Forbidden" or "Trial" without approval is a violation.

Category Technology Status Usage Context
Frontend Platform Next.js 14+ MANDATORY The App Router & Server Actions.
UI Primitives Radix UI MANDATORY Accessibility primitives (Dialogs, Popovers).
Styling Tailwind CSS MANDATORY Utility-first styling.
Enterprise UI Syncfusion MANDATORY Complex Data Grids, Charts, PDF/Word Editors.
Database Firestore MANDATORY Primary NoSQL Store (Document-based).
Secrets Doppler MANDATORY Environment variable injection.
State Management Zustand Suggested Client-side complex state (if Context is insufficient).
Forms React Hook Form Suggested Complex client-side validation.
Animation Framer Motion Suggested Layout transitions (use CSS for simple hovers).
ORM Prisma FORBIDDEN We use native Firestore SDKs or raw SQL if needed.

Process: To move a technology from Trial to Mandatory (or Suggested), you must submit an ADR to 03_technology/decisions/. | Version | Date | Author | Change | | :--- | :--- | :--- | :--- | | 1.0 | 2026-01-25 | AI | Extracted from Engineering Handbook |

Version History

Version Date Author Change
0.1.0 2026-01-26 Antigravity Initial Audit & Metadata Injection