Knowledge base
Documentation for doers — buyers, developers, and engineers.
Real estate moves fast. This page keeps onboarding, tooling, compliance, and support rituals in one place so every launch feels predictable.
Release readiness
We don't ship blind.
- Every MR references `docs/POST_DEPLOYMENT_CHECKLIST.md`.
- CTAs, auth, and analytics covered via automated tests.
- Rollback + observability plans logged before go-live.
For buyers & developers
Guided playbooks
Share these links with clients to help them explore listings, submit projects, or raise support tickets without waiting on email.
Buyer Journey
From discovery to booking — every touchpoint your clients experience on Rooflane.
- Browse curated projects with advanced filters and immersive media.
- Save favorites, compare units, and request guided walkthroughs.
- Book site visits or virtual tours while the system syncs with advisors in real-time.
- Receive financing tips, documentation checklists, and closing support.
Deep dives
- Project discovery tipsDeep dive on the UX choices that drive engagement.
docs/SPRINT_7_UX_ENHANCEMENTS.md - Mortgage calculator notesExplains financial tools available to buyers.
docs/MORTGAGE_CALCULATOR_TEST.md
Developer Console
Publish projects, upload compliance collateral, and track performance.
- Submit project data, floor plans, brochures, and RERA docs via guided forms.
- Collaborate with our employee review console for approvals and change requests.
- Monitor leads, appointments, and marketing analytics across launches.
Deep dives
- Submission workflowExplains gating, review flow, and statuses.
docs/PHASE1_STATUS.md - Storage setupChecklist for handling brochures and imagery.
docs/SETUP_STORAGE.md
Support Center
Self-serve answers plus direct access to the concierge team.
- Use the in-app messenger or WhatsApp to reach advisors within 2 minutes.
- Escalate financing or legal queries — we route them to the right specialists.
- Track ticket history and SLAs from the dashboard.
Deep dives
- Post-deployment checklistHow we keep uptime and response times transparent.
docs/POST_DEPLOYMENT_CHECKLIST.md
Engineering
Developer handbook
Everything needed to boot the stack, keep data safe, and release confidently.
Environment & Tooling
Spin up the full stack locally with Supabase, analytics, and storage.
- ↳Copy `.env.example` to `.env.local` and fill Supabase & Resend keys.
- ↳Run `npm install && npm run dev` to boot the Next.js app with hot reload.
- ↳Seed or migrate data using the SQL scripts inside `/supabase`.
References
- Platform setup —
docs/SETUP_GUIDE.md - Supabase schema —
supabase/schema.sql
Quality & Testing
Unit, integration, and end-to-end guidance for confident releases.
- ↳Use Jest + Testing Library for UI logic and utilities.
- ↳Use Cypress for user journeys (registration, dashboards, submissions).
- ↳Automate via GitLab CI before merging to production.
References
- System verification report —
docs/SYSTEM_VERIFICATION.md - Production test report —
docs/PRODUCTION_TEST_REPORT.md
Analytics & Security
Instrument events, guard data, and stay compliant.
- ↳Track CTAs through `analytics.clickCTA` and bespoke events.
- ↳Protect sensitive routes with middleware + Supabase RLS.
- ↳Monitor performance and errors via Sentry dashboards.
References
- Analytics implementation —
docs/ANALYTICS_SETUP.md - Security hardening —
docs/SECURITY_HARDENING_COMPLETE.md - Sentry setup —
docs/SENTRY_SETUP_GUIDE.md
Release checklist
Mirrors `docs/POST_DEPLOYMENT_CHECKLIST.md` so teams never miss a step.
- 1Lint + type-check clean (no warnings).
- 2Unit tests & Cypress suite green.
- 3Feature flags toggled appropriately.
- 4Content & translations reviewed.
- 5Observability dashboards updated.
Git basics
Merge requests include:
- Linked issue or OKR metric.
- Screenshot/video for UI updates.
- Test plan results (`npm run lint && npm run test:ci`).
- Fallback/rollback plan for prod.
Support channels
Dedicated inboxes so every user type has a predictable SLA.
Concierge Desk
buyers@rooflanerealty.com
Avg. 15 min response for buyers & residents.
Developer Success
builders@rooflanerealty.com
Same-business-day triage for submissions & leads.
Engineering On-Call
oncall@rooflanetech.com
Critical issues routed via PagerDuty 24/7.
Ask for help
Need live assistance? Hop on a 15-minute huddle with our platform team.
Email SupportOpen ticket from portalFAQ
Still curious?
Where do I track release readiness?
Each merge request must reference the release checklist in `docs/POST_DEPLOYMENT_CHECKLIST.md`. The dashboard widget on this page mirrors the same steps.
How do I request a new feature?
Log a ticket in Linear or fill the Feature Request form inside the portal (`/contact` → “Product Feedback”). We respond with sizing + ownership within 48 hours.
Do you support white-label deployments?
Yes. Reach out to the Partnerships pod for co-branded launches. We version control configurations via Supabase and feature flags.
docs/ARCHITECTURE.md