- Executive Summary
This SOW outlines the full end-to-end strategy to build, deploy, and maintain our app using industry best practices and a modular, API-first, cloud-native architecture.
- Scope of Work
2.1 Goals & Objectives
- Develop a mobile-first PWA with React and using App Router
- Design a modular, secure, and scalable backend API using API routes and AWS services
- Maintain infrastructure in AWS (S3, CloudFront, EC2, RDS, WAF, API Gateway, etc.)
- Enable offline support and push notifications using modern service worker architecture
Integrate code generation tools (Plasmic, Cursor AI) for speed and consistency
Application Architecture Overview
3.1 Frontend (React + )
- Framework: (with App Router)
- Rendering Strategy: Server Components (RSC) for static and dynamic SSR/CSR
- Routing: Dynamic routes using (slug), layouts via , and
- SPA-like Navigation: Use for internal links (no tags)
- PWA Support:
- for PWA metadata
- service- registered in
- Workbox for App Shell model and dynamic caching
3.2 Backend API + Cursor AI)
- Authentication: or custom JWT auth
- Business Logic: Modular logic written using Cursor AI into GitHub repo
- API Contracting: Stoplight to define, test, and document REST endpoints
- API Structure: /api/users, /api/bookings, /api/payments, etc.
3.3 Database (PostgreSQL on AWS RDS)
- Tables: Users, Entertainers, Bookings, Reviews, Venues, Messages, Payments
- Security: Encrypted queries at rest and in transit
- ORM: Prisma (optional) or native SQL
3.4 Infrastructure & Hosting (AWS)
4.1 Repository & Version Control
- GitHub (Monorepo):
- /apps/web → frontend
- /apps/backend → API logic (Cursor AI)
- /packages/ui → Plasmic-generated shared components
- /infrastructure → CDK/Terraform for AWS provisioning
4.2 Continuous Integration / Deployment
- GitHub Actions or Vercel CI for auto-deployments
- main → production, staging → pre-prod, plasmic → design sync branch
4.3 Code Style & Linting
5.1 UI Code Generation
- Tool:
Plasmic - Flow: Figma → Plasmic → GitHub → BookMeBabe
5.2 Backend Business Logic
- Tool:
Cursor AI - Cursor understands existing structure and writes logic into real codebase
- Smart code generation with modularity enforced
5.3 API & Schema Design
- A Free Database Designer for Developers and Analysts for data modeling
- Stoplight for REST contract simulation
AppMap for backend visualization
PWA Requirements & Service Worker Features
Camera Access
- Push Notifications (hosted push server TBD)
- Geolocation
- Offline Support:
- Static Assets → Cache-first via Workbox
- JSON APIs → IndexedDB
- SyncManager & Periodic Sync
Session Management / Stateful App
Environments
Production
: Live user environment
- Staging
: Full QA mirror Development
: Local GitHub + Codesandbox or dev EC2
Security & Compliance
HTTPS enforced across ALB and CloudFront
- Rate limiting, input validation, RBAC on all APIs
- Monitoring: AWS CloudWatch, Fluentd, optional Cribl/Splunk
Legal compliance work to be executed in parallel with dev
Timeline
Week.
Task
1-2 Infra Setup, Figma → Plasmic Conversion, Monorepo Bootstrapping
3-4 Backend APIs, Database Schema, Auth Setup
5-6 Frontend Integration, Booking Logic, Admin Panel
7 QA & Testing
8 Production Deployment
Deliverables
Fully deployed PWA with SSR/CSR
- GitHub repo (monorepo) with codebase and documentation
- Working service workers, push, offline caching
- Integrated Stripe/Payment Flow (via API)
- Legal/Compliance-ready documentation
Memo-ready architecture and database diagrams
Acceptance Criteria
All UI components generated and committed in GitHub
- PWA passes Lighthouse audits (SEO, Performance, Accessibility)
- APIs return expected JSON with error handling
- Database deployed with test data and secured
- Environments deployed: staging + prod
- Legal sign-off obtained from regulatory counsel
We are currently building our MVP and only want candidates that have teams bilingual and ready to go