Open Source Friendly

Tech Stack

Built with modern tools and practices. Designed for scale, performance, and developer happiness.

Technology Stack

We use proven technologies that scale and modern tools that make development enjoyable.

Frontend

Next.js 14

App Router, Server Components

TypeScript

Type-safe development

Tailwind CSS

Utility-first styling

Framer Motion

Smooth animations

shadcn/ui

Accessible component library

Backend

Node.js

Runtime environment

PostgreSQL

Primary database

Prisma

Type-safe ORM

Redis

Caching and sessions

Stripe

Payment processing

AI/ML

OpenAI GPT-4

Language understanding

LangChain

AI application framework

Pinecone

Vector database for RAG

Python

ML model development

Hugging Face

Model hosting and fine-tuning

Infrastructure

Vercel

Frontend deployment

Railway

Backend hosting

AWS S3

File storage

Cloudflare

CDN and security

GitHub Actions

CI/CD pipeline

AI Architecture

How our AI memory system learns, stores, and applies customer preferences.

RAG-Powered Memory Pipeline

Customer feedback → Structured preferences → Crew briefings

Customer Feedback

AI Processing

Vector Storage

Crew Briefing

Preference Extractor

Analyzes customer feedback and extracts structured preferences using NLP

OpenAI GPT-4Custom promptsValidation rules

Memory Store

Vector database storing customer preferences with semantic search

PineconeOpenAI EmbeddingsMetadata filtering

Briefing Generator

Creates personalized crew instructions from stored preferences

LangChainTemplate engineContext optimization

Feedback Loop

Continuously improves preferences based on service outcomes

Reinforcement learningSatisfaction scoringAuto-updates

Code Style & Standards

Our development principles ensure maintainable, scalable, and reliable code.

Type Safety First

Strict TypeScript with no 'any' types in production code

Example: All API responses, database schemas, and component props are fully typed

Component Composition

Small, reusable components with clear interfaces

Example: Each UI component has a single responsibility and accepts typed props

Server-First Architecture

Leverage Next.js Server Components for better performance

Example: Data fetching happens on the server, client components only for interactivity

Error Boundaries

Graceful error handling at every level

Example: API errors, validation failures, and UI errors are all handled gracefully

Contribution Guide

Ready to contribute? Here's how to get started with our development workflow.

1. Setup

Fork the repository on GitHub
Clone your fork locally
Install dependencies with npm install
Copy .env.example to .env.local

2. Development

Create a feature branch from main
Run npm run dev for local development
Follow our TypeScript and ESLint rules
Write tests for new functionality

3. Testing

Run npm run test for unit tests
Test manually in multiple browsers
Ensure accessibility with screen readers
Check mobile responsiveness

4. Submission

Push your branch to your fork
Open a pull request to main
Fill out the PR template completely
Respond to code review feedback

PR Checklist

Before submitting a pull request, ensure your code passes all checks:

TypeScript compiles

ESLint passes

Tests pass

Accessibility tested

Performance & Security

Built for speed, reliability, and security from day one.

Performance Targets

Core Web VitalsExcellent

LCP < 2.5s, CLS < 0.1, FID < 100ms

Bundle Size< 100KB

Gzipped JavaScript for home page

Lighthouse Score95+

Performance, Accessibility, Best Practices, SEO

Security Measures

Data EncryptionAES-256

End-to-end encryption for sensitive data

API SecurityOAuth 2.0

Rate limiting, CORS, input validation

PrivacyGDPR Ready

Data minimization, user consent, right to deletion

Ready to contribute?

Join our open-source community and help build the future of AI-powered home services.

Join the Team