Transform property photos with AI. Upload images, select styles, and generate stunning real estate visuals instantly.
Introduction · Features · Installation · Tech Stack · Architecture · Contributing
RealtyLens is a cutting-edge real estate photo editing platform that leverages artificial intelligence to transform property photographs. Upload your real estate images, choose from professionally curated style templates, and let AI enhance your listings with stunning visuals that capture attention and drive more showings.
Why RealtyLens?
- AI-Powered Editing – Transform ordinary property photos into professional marketing materials
- Style Templates – Curated collection of real estate photography styles (modern, luxury, cozy, etc.)
- Instant Processing – Generate enhanced images in seconds using Fal.ai
- Team Collaboration – Work together with your real estate team in shared workspaces
- White-label Ready – Custom branding options for agencies and brokerages
Upload property photos and apply AI-powered enhancements. Choose from professionally designed style templates that transform ordinary photos into marketing-ready visuals optimized for real estate listings.
Curated collection of photography styles including:
- Modern Minimalist – Clean lines, contemporary appeal
- Luxury Estate – High-end, sophisticated presentation
- Cozy Family Home – Warm, inviting atmosphere
- Urban Chic – City lifestyle appeal
Create collaborative workspaces for your real estate team:
- Role-based Access – Owner, admin, and member permissions
- Shared Projects – Work together on property listings
- Team Invitations – Invite members via email
- Custom Branding – White-label options for agencies
Organize your photo editing projects with:
- Project Dashboard – Grid and table views of all projects
- Before/After Comparison – Side-by-side image comparison
- Status Tracking – Monitor processing status and completion
- Bulk Operations – Edit multiple photos simultaneously
Comprehensive admin functionality for platform management:
- User Management – View and manage all users
- Workspace Oversight – Monitor team workspaces
- Analytics Dashboard – Track usage and performance metrics
# 1. Clone the repository
git clone https://github.com/codehagen/proppi.git
cd proppi
# 2. Install dependencies
bun install
# 3. Copy environment variables
cp .env.example .env.local
# 4. Set up the database
bun db:push
# 5. Set up Trigger.dev (Background Jobs)
# Get your TRIGGER_SECRET_KEY from https://cloud.trigger.dev
# Add it to .env.local as TRIGGER_SECRET_KEY=tr_dev_xxxxxxxxxx
# 6. Start development servers (run in separate terminals)
# Terminal 1: Next.js dev server
bun dev
# Terminal 2: Trigger.dev dev server (for background jobs)
bun triggergit clone https://github.com/codehagen/proppi.git
cd proppi
bun installCopy the example environment file:
cp .env.example .env.localUpdate .env.local with your credentials:
DATABASE_URL– PostgreSQL connection stringFAL_API_KEY– Fal.ai API key for AI image processingBETTER_AUTH_SECRET,BETTER_AUTH_URL,NEXT_PUBLIC_APP_URLRESEND_API_KEY– Email delivery service
Push the database schema:
bun db:push| Command | Description |
|---|---|
bun dev |
Start Next.js development server |
bun trigger |
Start Trigger.dev development server (background jobs) |
bun build |
Production build |
bun start |
Start production server |
bun lint |
Run ESLint |
bun db:push |
Push schema changes to database |
bun db:generate |
Generate Drizzle migrations |
bun db:studio |
Open Drizzle Studio |
bun email |
Preview email templates |
Important: For local development, you need to run both
bun dev(Next.js) andbun trigger(Trigger.dev) in separate terminals. The Trigger.dev server handles background task processing.
- Next.js 16 – App Router, Server Actions, TypeScript
- React 19 – Latest React with concurrent features
- TypeScript 5 – Type-safe development
- PostgreSQL – Primary database
- Drizzle ORM – Type-safe database operations
- Better Auth – Modern authentication with OAuth providers
- Session Management – Secure session handling
- Fal.ai – AI-powered image generation and editing
- Custom Style Templates – Curated prompts for real estate photography
- Tailwind CSS v4 – Utility-first CSS framework
- shadcn/ui – High-quality React components
- Radix UI – Accessible component primitives
- @tabler/icons-react – Consistent icon library
- ESLint – Code linting and formatting
- Drizzle Kit – Database migration and studio
- React Email – Email template development
- Vercel – Deployment and preview environments
- Supabase – PostgreSQL database and storage
- Trigger.dev – Background jobs and task scheduling
- Resend – Email delivery infrastructure
RealtyLens follows a modern web application architecture:
┌─────────────────┐ ┌──────────────────┐
│ Fal.ai API │────▶│ ImageGeneration │
│ (AI Processing) │ │ Style Templates │
└─────────────────┘ └────────┬─────────┘
│
▼
┌─────────────────┐ ┌──────────────────┐
│ Better Auth │────▶│ User Session │
│ (Authentication)│ │ Workspace │
└─────────────────┘ │ Team Members │
└────────┬─────────┘
│
▼
┌──────────────────┐
│ Dashboard │
│ Projects │
│ Admin Panel │
└──────────────────┘
app/
├── dashboard/ # Main project dashboard
│ ├── page.tsx # Projects grid with view toggle
│ ├── layout.tsx # Dashboard layout with header
│ ├── settings/ # Workspace & team settings
│ └── [id]/ # Individual project detail
├── admin/ # Admin panel
│ ├── users/ # User management
│ ├── workspaces/ # Workspace oversight
│ └── layout.tsx # Admin layout
├── api/
│ ├── auth/ # Better Auth endpoints
│ └── edit-photo/ # Fal.ai image processing
lib/
├── db/
│ ├── schema.ts # Drizzle database schema
│ └── index.ts # Database client
├── mock/ # Mock data for development
├── style-templates.ts # AI style templates
├── auth.ts # Better Auth configuration
└── siteconfig.ts # Site configuration
components/
├── ui/ # shadcn/ui base components
├── dashboard/ # Dashboard-specific components
├── projects/ # Project creation workflow
├── settings/ # Settings page components
├── admin/ # Admin panel components
└── tables/ # Data tables with virtual scrolling
# Database
DATABASE_URL=postgresql://username:password@localhost:5432/proppi
# AI Processing
FAL_API_KEY=your_fal_api_key_here
# Authentication
BETTER_AUTH_SECRET=your_secret_key
BETTER_AUTH_URL=http://localhost:3000
NEXT_PUBLIC_APP_URL=http://localhost:3000
# Email
RESEND_API_KEY=your_resend_api_key
# Trigger.dev (Background Jobs)
TRIGGER_SECRET_KEY=tr_dev_xxxxxxxxxxNote: For local development with Trigger.dev, you need to:
- Get your DEV secret key from the API Keys page in your Trigger.dev project dashboard
- Add it to your
.env.localfile asTRIGGER_SECRET_KEY- Run
bun triggerin a separate terminal to start the Trigger.dev development server
We love our contributors! Here's how you can contribute:
- Open an issue if you believe you've encountered a bug.
- Make a pull request to add new features/make quality-of-life improvements/fix bugs.
This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE.md file for details.
Built for real estate professionals who want to showcase properties in their best light.