Ever Teams is a modern, full-stack, cross-platform application built with industry-standard open-source technologies. This page provides a high-level view of the system architecture.
Technology Stack
Frontend
| Technology | Usage |
|---|
| Next.js (v16) | Server-side rendering, file-based routing, API routes |
| React (v19) | UI component library |
| Tailwind CSS | Utility-first CSS framework |
| shadcn/ui | Accessible, customizable component primitives |
| Radix UI | Headless UI component library |
| HeadlessUI | Unstyled, accessible UI components |
| Recoil | State management for React |
| next-intl | Internationalization (13+ locales) |
| Sentry | Error tracking and performance monitoring |
Mobile
| Technology | Usage |
|---|
| React Native | Cross-platform mobile framework |
| Expo | Development toolchain and managed workflow |
Desktop
| Technology | Usage |
|---|
| Electron | Desktop application shell |
Browser Extensions
| Technology | Usage |
|---|
| Plasmo | Browser extension framework |
Backend (Ever Gauzy API)
Ever Teams relies on the Ever Gauzy platform for its backend:
System Architecture
Data Flow
Authentication Flow
Timer Flow
Deployment Architecture
Docker Compose (Production)
Key Design Decisions
| Decision | Rationale |
|---|
| Next.js API proxy | Avoids CORS issues, keeps API keys server-side, enables middleware |
| Recoil for state | Fine-grained subscriptions, async selectors, atom-based architecture |
| Monorepo with shared packages | Code reuse across web, mobile, and desktop apps |
| Ever Gauzy as backend | Leverages a mature ERP/CRM/HRM platform instead of building from scratch |
| Docker Compose for infra | One-command deployment of all required services |
| TypeScript everywhere | Type safety across the full stack |