Transform static proposals into interactive, collaborative, and trackable web links to help service businesses close deals faster.
Status: Active development / design-partner MVP. Core create → send → public view loop is the priority. Not marketed as production self-serve SaaS yet.
VPS deploy: see
VPS_DEPLOY.md— production URLhttps://syncquote.faizanmalik.me.
🎉 Major Update: 6 powerful new features have been added!
- 📄 Proposal Templates - Create proposals 70% faster with reusable templates
- 🔔 Real-Time Notifications - Instant alerts via WebSocket and email
- 💬 Advanced Collaboration - Threaded comments, @mentions, and resolution tracking
- 📊 Analytics Dashboard - Track engagement, conversion rates, and performance
- 📝 Audit Trail System - Complete activity logging for compliance
- 🎨 White-labeling - Custom branding with logos and colors
- Primary: NestJS (Node.js + TypeScript) - Main API backend
- Database: PostgreSQL 16 with Prisma ORM
- Caching: Redis
- Authentication: JWT + Google OAuth
- Payments: Stripe (Billing + Connect)
- Real-time: Socket.io
- Email: Resend (SendGrid optional fallback)
- Storage: AWS S3 / Cloudflare R2
- Monitoring: Sentry + Pino logging
- API Docs: Swagger/OpenAPI
- Framework: Next.js 14 (React 19)
- Styling: Tailwind CSS + shadcn/ui
- State: TanStack Query
- Forms: React Hook Form + Zod
- Editor: Tiptap (Block-based proposal editor)
- Backend: AWS ECS Fargate (Docker)
- Frontend: Vercel
- Database: AWS RDS PostgreSQL
- Cache: AWS ElastiCache Redis
- Storage: AWS S3
- IaC: Terraform
- CI/CD: GitHub Actions
- Node.js 20+
- PostgreSQL 16+
- Redis 7+
- Docker (for containerization)
- AWS Account (for production deployment)
- Terraform (for infrastructure)
SyncQuote/
├── backend/ # ARCHIVED — unused Django scaffold (not the product stack)
├── backend-nestjs/ # Primary NestJS backend API
│ ├── src/
│ │ ├── modules/ # Feature modules
│ │ │ ├── auth/ # Authentication & authorization
│ │ │ ├── users/ # User management
│ │ │ ├── proposals/ # Proposal CRUD
│ │ │ ├── comments/ # Comments system
│ │ │ ├── webhooks/ # Stripe webhooks
│ │ │ ├── storage/ # S3/R2 file storage
│ │ │ ├── email/ # Email notifications
│ │ │ ├── events/ # WebSocket events
│ │ │ ├── prisma/ # Database service
│ │ │ └── health/ # Health checks
│ │ ├── app.module.ts
│ │ └── main.ts
│ ├── prisma/
│ │ └── schema.prisma # Database schema
│ ├── Dockerfile
│ └── package.json
├── frontend/ # Next.js frontend
│ ├── src/
│ │ ├── app/ # App router pages
│ │ ├── components/ # React components
│ │ │ └── ui/ # shadcn/ui components
│ │ ├── hooks/ # Custom React hooks
│ │ ├── lib/ # Utilities
│ │ └── constants/ # Constants & configs
│ ├── public/
│ ├── Dockerfile.dev
│ └── package.json
├── mobile/ # React Native mobile app
│ ├── src/
│ │ ├── App.tsx
│ │ ├── constants/
│ │ ├── navigation/
│ │ ├── screens/
│ │ ├── services/
│ │ ├── store/
│ │ ├── types/
│ │ └── utils/
│ └── package.json
├── terraform/ # Infrastructure as Code
│ └── main.tf # AWS resources
├── docker-compose.yml # Local development setup
└── README.md # This file
# Clone and start all services
git clone https://github.com/yourusername/syncquote.git
cd syncquote
docker-compose up -d
# Access:
# - Frontend: http://localhost:3000
# - Backend: http://localhost:3001
# - API Docs: http://localhost:3001/api/docs# Backend
cd backend-nestjs
npm install
# Frontend (in new terminal)
cd ../frontend
npm installBackend (.env):
DATABASE_URL="postgresql://user:password@localhost:5432/syncquote"
JWT_ACCESS_SECRET=your-secret-key
JWT_REFRESH_SECRET=your-refresh-secret
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
STRIPE_SECRET_KEY=sk_test_...
RESEND_API_KEY=re_...
EMAIL_FROM=noreply@faizanmalik.me
AWS_ACCESS_KEY_ID=your-aws-key
AWS_SECRET_ACCESS_KEY=your-aws-secret
S3_BUCKET=syncquote-assetsFrontend (.env.local):
NEXT_PUBLIC_API_URL=http://localhost:3001/api/v1
NEXT_PUBLIC_WS_URL=ws://localhost:3001cd backend-nestjs
# Generate Prisma Client
npx prisma generate
# Run migrations
npx prisma migrate dev
# (Optional) Seed database
npm run seed
# (Optional) Open Prisma Studio
npx prisma studioTerminal 1 - Backend:
cd backend-nestjs
npm run start:dev
# API: http://localhost:3001/api/v1
# Docs: http://localhost:3001/api/docsTerminal 2 - Frontend:
cd frontend
npm run dev
# App: http://localhost:3000cd backend-nestjs
# Unit tests
npm run test
# E2E tests
npm run test:e2e
# Coverage
npm run test:covcd frontend
# Run tests (when implemented)
npm run test| File | Purpose |
|---|---|
| QUICK_START.md | Get started quickly with development setup |
| ARCHITECTURE.md | System architecture and data flows |
| DEPLOYMENT.md | Production deployment guide |
| README.md | This file - project overview |
See DEPLOYMENT.md for complete production deployment instructions.
# Infrastructure (Terraform)
cd terraform
terraform init
terraform plan -var-file="production.tfvars"
terraform apply -var-file="production.tfvars"
# Backend (GitHub Actions auto-deploys on push to main)
# Frontend (Vercel)
cd frontend
vercel --prodOnce the backend is running, access the Swagger docs at:
- Local: http://localhost:3001/api/docs
- Production: https://api.syncquote.com/api/docs
- ✅ HTTPS enforced everywhere
- ✅ JWT access tokens (15min) + httpOnly refresh tokens (7 days)
- ✅ Bcrypt password hashing (12 rounds)
- ✅ Input validation with class-validator
- ✅ Rate limiting on all endpoints
- ✅ CORS configured
- ✅ Helmet security headers
- ✅ SQL injection protection (Prisma ORM)
- ✅ XSS protection
- ✅ CSRF protection via SameSite cookies
- ✅ Secrets in AWS Secrets Manager
- ✅ Database connection over SSL
- Error Tracking: Sentry (backend & frontend)
- Logging: Pino → CloudWatch Logs
- Uptime: UptimeRobot pinging
/health - Metrics: AWS CloudWatch + ECS Container Insights
This is a private SaaS project. For team members:
- Create a feature branch:
git checkout -b feature/my-feature - Commit changes:
git commit -m 'Add my feature' - Push branch:
git push origin feature/my-feature - Open a Pull Request
Proprietary - All rights reserved
For issues or questions:
- Backend: Check logs in CloudWatch
- Frontend: Check Vercel deployment logs
- Database: Check RDS metrics in AWS Console
- Contact: dev@syncquote.com