Skip to main content

ADR-006: Frontend — Next.js

Status: Accepted Date: May 2026

Context

BayanCore requires a modern frontend framework with excellent RTL support, performance, and developer experience.

Decision

Next.js (React) is selected as the frontend framework.

Rationale:

  • Excellent RTL support with CSS logical properties
  • Server-side rendering for performance
  • Strong ecosystem and community
  • TypeScript support out of the box
  • PWA capabilities for mobile experience

Consequences

  • Positive: Fast development, strong ecosystem, excellent performance
  • Trade-offs: React learning curve for some developers
  • Risks: Framework evolution may require migration

Alternatives Considered

  • Vue.js: Good RTL support but smaller enterprise ecosystem
  • Angular: Heavy, complex setup
  • Svelte: Emerging ecosystem, less proven at scale