Pathfinder Docs

Documentation Preview

šŸš€ Quick Start - Property Management CRM with Supabase

Source: `docs/operations/QUICK_START.md`View on GitHub

šŸš€ Quick Start - Property Management CRM with Supabase

What You Have Now

āœ… Property Management Companies Feature

  • Add, edit, delete companies
  • Search and filter
  • Track contacts, status, and priorities
  • Beautiful UI with stats dashboard

āœ… Supabase Integration Ready

  • Database configured
  • All CRUD operations ready
  • Automatic fallback to localStorage
  • Multi-user support ready

What You Need to Do (5 Minutes)

1. Set Up Supabase (First Time Only)

# You have two options:

Option A: Create New Supabase Project (Recommended)

  1. Go to https://supabase.com and sign up (free)
  2. Create a new project called pathfinder
  3. Wait 2-3 minutes for setup
  4. Follow the detailed guide in SUPABASE_SETUP.md

Option B: Use Existing Data (If You Already Have Companies in localStorage)

  • The app will continue working with localStorage until you set up Supabase
  • Your data is safe and won't be lost

2. Create Your .env.local File

# Copy the template
cp .env.local.template .env.local

# Then edit .env.local with your actual Supabase credentials

3. Restart Dev Server

# Stop current server (Ctrl+C)
npm run dev

4. Test It!

  1. Go to http://localhost:3000/access-crm
  2. Scroll to "Property Management Companies" section
  3. Click "+ Add Company"
  4. Add a test company
  5. It should save to Supabase! šŸŽ‰

For Cole (or Anyone Else on Your Team)

Share your .env.local file contents securely with Cole:

NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGci...

Cole should:

  1. Clone/pull the latest code
  2. Run npm install (Supabase is now a dependency)
  3. Create his own .env.local with the same credentials
  4. Run npm run dev

Both of you will see the same data! šŸ¤

File Structure

pathfinder/
ā”œā”€ā”€ app/
│   └── access-crm/
│       └── page.tsx          ← Property Management feature
ā”œā”€ā”€ lib/
│   └── supabase.ts           ← Supabase configuration (NEW)
ā”œā”€ā”€ .env.local                ← Your credentials (create this)
ā”œā”€ā”€ .env.local.template       ← Template for reference
ā”œā”€ā”€ SUPABASE_SETUP.md         ← Detailed setup guide
└── QUICK_START.md            ← This file

Database Schema

Your Supabase table property_management_companies has:

  • id: Unique identifier
  • company_name: Name of the PM company
  • address, city, state, zip_code: Location info
  • contact_name, contact_title: Primary contact
  • phone, email, website: Contact methods
  • units_managed: Number of units they manage
  • status: Not Contacted | Contacted | In Discussion | Partner | Not Interested
  • priority: Low | Medium | High
  • notes: Additional information
  • created_at, updated_at: Timestamps

What's Working Right Now

Even without Supabase setup:

  • āœ… Add companies (saves to localStorage)
  • āœ… Edit companies
  • āœ… Delete companies
  • āœ… Search functionality
  • āœ… All stats and dashboards
  • āœ… Beautiful UI
  • āœ… Data persists in browser

With Supabase setup:

  • āœ… Everything above PLUS
  • āœ… Multi-user access (you + Cole)
  • āœ… Cloud backup
  • āœ… Data syncs across devices
  • āœ… Can view/edit in Supabase dashboard

Troubleshooting

"Can't connect to Supabase"

  • Did you create .env.local?
  • Did you restart the dev server?
  • Check your credentials are correct

"Still using localStorage"

  • That's the fallback! It's working as designed
  • Set up Supabase when you're ready

"Cole can't see my data"

  • Make sure he has the same .env.local credentials
  • Both must be using Supabase (not localStorage)

Next: Start Adding Companies!

You're ready to build your Oregon property management company database:

  1. Portland Metro Area

    • Search for PM companies online
    • Add them to your CRM
    • Track contact status
  2. Other Oregon Markets

    • Eugene, Salem, Bend, etc.
    • Build comprehensive database
    • Set priorities for outreach
  3. Use for Range Rental Search

    • Track partnerships
    • Monitor units available
    • Build relationships

Need Help?


Ready? Create your .env.local file and let's go! šŸš€


Use links in each imported doc to open its source.