Official Tech Stack for Maktabati — The ultimate Goodreads killer for Arabic readers.
Status Key:
[x]= Currently in use / fully integrated[ ]= Planned for future phases
- Neon Postgres — Serverless Postgres with branching, autoscaling, and built-in RLS. Primary data store for all platform data.
- Drizzle ORM — Type-safe ORM with Drizzle Kit for migrations and Drizzle Studio for database inspection.
- Neon Auth (built on Better Auth) — Database-native authentication. Handles sessions, OAuth, and email/password out of the box.
- TanStack Start v1 — Full-stack React framework powered by Vite and Vinxi. Server Functions replace traditional API routes.
- TanStack Router — Fully type-safe file-based routing with built-in search param validation and route loaders.
- Vite — Build tool and dev server. Significantly faster than Webpack-based alternatives.
- TanStack Query — Server state management: caching, background refetching, and optimistic updates.
- TanStack Table — Headless table primitives for book catalog, admin dashboards, and analytics.
- TanStack Form — Type-safe form handling with Zod integration.
- TanStack Virtual — Virtualized lists for rendering large book catalogs without performance degradation.
- Tailwind CSS v4 — Utility-first CSS, RTL-first configuration.
- Shadcn/UI (Nova — Base UI) — Component library built on Base UI primitives instead of Radix.
- Base UI — Unstyled, accessible primitives powering Shadcn Nova components.
- Dark Mode - Shadcn's
next-themesalternative for tanstack start - Phosphor Icons — Consistent icon library with React package and SSR-safe imports.
- Sonner — Toast notifications.
- Fontsource (Arabic subsets) — Self-hosted Arabic fonts (Noto Naskh Arabic, Noto Sans Arabic).
- Shadcn Charts (Recharts) — Reading heatmaps, genre breakdowns, and yearly stats.
- Zod — Runtime schema validation. Used across Server Functions, forms, and API boundaries.
- t3-env — Type-safe environment variable validation on startup.
- date-fns — Lightweight, tree-shakeable date utility library (Arabic locale included).
- pnpm — Fast, disk-efficient package manager with strict dependency isolation.
- Biome — Replaces ESLint + Prettier. Single tool for linting and formatting.
- TypeScript (strict) — Full type safety across frontend, backend, DB schema, and router.
- Zed — Primary high-performance IDE.
- Vitest + Playwright — Unit, integration, and end-to-end testing.
- Turborepo — Monorepo management for scaling.
- Tauri v2 — Desktop and mobile apps sharing the same Vite/React codebase.
- Fumadocs — Developer and publisher documentation site.
- Cloudflare R2 — S3-compatible object storage with zero egress fees.
- Resend — Transactional email with React Email for templates.
- Trigger.dev v3 — Background jobs for book imports and scheduled updates.
- Upstash (Redis) — Serverless Redis for rate limiting and hot data caching.
- Typesense — Typo-tolerant full-text search engine for Arabic book discovery.
- PostHog — Product analytics, feature flags, and session replay.
- Sentry — Error monitoring and performance tracing.