Tech Stack
A consolidated view of all technologies used across the SMACKZ platform.
Backend
| Technology |
Usage |
Services |
| Node.js (20+) |
Server runtime |
Yum, POS Adapters, MCP Gateway |
| Fastify v5 |
HTTP framework |
Yum, POS Adapters |
| TypeScript |
Language |
All Node.js and React services |
| Drizzle ORM |
Database access |
Yum, POS Adapters |
| Zod |
Schema validation |
Yum, POS Adapters |
| PostgreSQL 14 |
Transactional database |
Yum (primary), POS Adapters |
| Redis (ioredis) |
Caching, sessions, event streams |
Yum, Lakehouse Writer |
| Firebase Admin SDK |
Auth token verification |
Yum |
| Python 3.12 |
Server runtime |
MCP Server, Lakehouse |
| FastAPI |
HTTP framework |
Lakehouse Query API |
| FastMCP |
MCP protocol server |
MCP Server |
| DuckDB |
Embedded analytics engine |
Lakehouse Query API, Metabase |
Frontend
| Technology |
Usage |
Services |
| React 19 |
UI framework |
Admin, Websites, KDS-Web, Page Renderer |
| Vite 7 |
Build tool |
Admin, Websites, KDS-Web |
| TailwindCSS v4 |
Styling |
Websites, Admin |
| Redux Toolkit + RTK Query |
State management |
Admin |
| React Hook Form + Yup |
Form handling |
Admin |
| Zustand |
State management |
Mobile |
| React Query |
Server state |
Mobile, KDS-Web |
| React Native CLI |
Mobile framework |
SMACKZ-MOBILE |
Infrastructure
| Technology |
Purpose |
| Docker Compose |
Local development environment |
| Control Plane (cpln) |
Cloud deployment for backend services |
| Cloudflare Pages |
Static site hosting (Admin, Websites) |
| Cloudflare R2 |
Object storage (images, Parquet files) |
| GitHub Actions |
CI/CD pipelines |
| GitHub Packages |
npm package registry (shared-core, shared-ui) |
| Firebase |
Authentication (Phone Auth, Identity Platform) |
| Resend.com |
Transactional email |
| Neon |
Managed PostgreSQL (cloud environments) |
Analytics
| Technology |
Purpose |
| DuckDB |
Embedded SQL query engine for analytics |
| PyArrow |
Typed Parquet file writing |
| Parquet |
Columnar storage format on R2 |
| Metabase (OSS) |
Self-service dashboards and SQL editor |
| Redis Streams |
Event ingestion pipeline |
External Integrations
| Integration |
Purpose |
| Clover POS |
Order and menu sync with physical POS terminals |
| Google Maps API |
Geocoding and restaurant location services |
| Twilio |
SMS notifications |
| Cloudflare Images API |
WebP/AVIF conversion and responsive variants |
Shared Packages
| Package |
Scope |
Consumers |
@smackz-llc/shared-core |
Auth, API clients, TypeScript types |
Admin, Websites, Mobile |
@smackz-llc/shared-ui |
Reusable UI components |
Admin, Websites |
@smackz-llc/page-renderer |
Dynamic page section rendering |
Websites |
Key Files
CLAUDE.md -- Project structure tabledocs/CI-CD-Workflows.md -- Package publishing and consumptionyum/package.json -- Backend dependenciesSmackz-Admin/package.json -- Admin frontend dependencies