Skip to content

Latest commit

 

History

History
163 lines (131 loc) · 9.5 KB

local-lab.md

File metadata and controls

163 lines (131 loc) · 9.5 KB

The Local Lab mark: a paper D in green with a map pin

Local Lab

Local service directories with the revenue already wired in.

Kit page · Docs · Pricing · Back to the tour

The codebase behind real directories for detailers, locksmiths, roofers, pool cleaners and window cleaners. One install becomes any local niche from the admin panel: import the businesses, set your prices, and every city you add is a new page and a new thing to sell. Runs on a $5 a month host. Starts on SQLite with no setup and moves to PostgreSQL when you grow.

Local Lab: the two-step setup wizard, the Greenkeep directory it produced, the CSV import result, the featured listings and leads screens in the admin, and a city page

Every admin screen below is from a demo directory called Greenkeep, filled with made-up businesses and numbers. Nothing here is a mock-up.

The setup wizard, step by step

A new install opens on a two-step wizard. It asks for the directory, then the admin account, and lands on the dashboard. It shows once.

Step one of the Local Lab setup wizard, Your directory: the two steps listed down the left beside the Local Lab mark, and on the right the site name, the industry and the country, with a Continue button Step two of the Local Lab setup wizard, Your account: boxes for the username, email, password and the password again, and a Create directory button
The setup wizard, shown once on a new install. The second step makes the admin account.

Guide: Install Local Lab on your computer.

See it running

The home page of a Local Lab directory called Greenkeep: a search bar over a banner reading Find the Best Lawn Care Services, with category tiles below The Austin city page of the Greenkeep directory, listing lawn care businesses in Austin with their ratings and categories
The home page of a directory built with Local Lab. Every city with listings gets its own page.
A business page for Greywell Lawn Care in Austin with its description, star rating, phone number, selling points and prices The Local Lab admin dashboard: a growth chart of new users and listings over 30 days, with totals for users, quote requests, sales revenue, listings and reviews
A business page, built from one row of the import file. The admin dashboard.
The lower half of the admin dashboard: recent listings on the left and the Quick Actions menu on the right, grouped into Content, Revenue and System The Manage Listings page after an import, with a bar across the top reading Import completed
Quick Actions on the dashboard is the menu for every admin screen. After an import you land on Listings with the result across the top.
The Featured Listings page: homepage slots taken, city featured listings, revenue, and a table of the businesses featured on the home page The Lead Suite Dashboard: tiles for total leads, pending, subscribers and monthly recurring revenue, with recent quote requests and recent subscriptions
Admin, Featured: three paid placements, home page, city and category. Admin, Leads: quote requests and the businesses paying to receive them.

Four ways to charge, already built

  • Lead marketplace. Customers request quotes for free. Businesses pay monthly per city to receive them, with a limited number of places per city.
  • Homepage featured listings. One-off or monthly, with limited slots, paid through Stripe and expired automatically.
  • City and category sponsorship. Businesses pay to appear at the top of their own city or category page.
  • Ad slots. AdSense placements built into the layouts, so income can start from the first visitor.

What it does

  • Fill a city in minutes. The Google Places importer finds businesses for any city and category. CSV import handles thousands of rows with duplicate detection.
  • A page for every city and service. City, category and "near me" pages are generated from your data, with sitemaps and structured data.
  • AI clean-up. Claude rewrites scraped descriptions and writes selling points before import.
  • No code between niches. Name, logo, colours, categories, pricing and email templates are admin settings.
  • Outreach that runs itself. Automated email with bounce handling, and cold outreach when a city has leads but no subscriber.
  • Run it from your phone. A Telegram bot sends new listings, claims and payments with one-tap approve buttons.

Wired in

Part What it does
Flask Python 3.11, Gunicorn, about 120 admin routes
Tailwind Colours and fonts themed from the admin
Stripe Checkout, subscriptions, webhooks, refunds ledger
Google sign-in One click, verified email, password reset
Email Any SMTP, 26 emails, campaigns, bounce handling
reCAPTCHA Register, forgot password, contact
Claude Rewrites descriptions, writes selling points
Google Places Scrape businesses by city, import-ready CSV
Geocoding OpenCage, map embeds, directions
PostgreSQL Or SQLite, 36 migrations
Docker + nginx HTTPS, multi-site deploy, nightly backups
Telegram Alerts, approve listings from your phone
Google Analytics GA4 events, AdSense slots

And the rest: sitemap and robots, LocalBusiness JSON-LD, OG tags, rate limits, CSRF, legal pages, branded error pages.

The guides

Every guide was written from the code and checked on a fresh copy of each release. All of them are free to read.

Start here What Local Lab is · Install · Admin tour · Make it your niche

Fill the directory The data pipeline · Google Places · Claude clean-up · Import a CSV · Cities and map pins · Listings and claims

Earn Connect Stripe · Featured listings · Sell leads · Ads

Grow SEO · Email, campaigns and bounces · Cold outreach · Telegram and sign-in

Go live Deploy · Domains and HTTPS · Backups and PostgreSQL

Keep it running Updating · Troubleshooting

Built with it

mobiledetailing.io, mobile car detailers across the US · usalocksmith.io, a US locksmith directory · windowcleaners.io, window cleaning companies by city · usaroofers.io, roofing contractors across the US · poolcleaners.io, pool cleaning and maintenance services

Tiers

  • Starter. Just the code: the full source as a download, every revenue stream, unlimited sites you own, and the documentation. No updates and no support.
  • Professional. Everything in Starter, plus the private GitHub repository, updates for life by git pull, the buyers' community and email support.
  • Enterprise. Everything in Professional, plus the tooling for running a portfolio of sites, priority support and a 30 minute one-to-one setup call.

What each tier adds for this kit, and the prices, are on the kit page.