Under the
Hood
AutoGnome is built on best-in-class open and commercial tools. Here’s exactly what powers every feature — and why each piece was chosen.
14 technologies. One platform.
Every dependency chosen for a reason — no filler.
Next.js 15
App Router, React Server Components, and API routes power every page. Turbopack handles local dev; each deploy ships to the Vercel edge.
React 19
Client components handle interactivity — maps, search, filters, modals, and the bottom sheet. Server components own data-fetching and layout.
TypeScript
End-to-end type safety from database row types (generated by Supabase CLI) through API routes, hooks, and UI components.
Supabase
PostgreSQL + PostGIS for spatial queries, Supabase Auth for user accounts, Storage for listing photos. Row-level security locks every table.
PostgreSQL + PostGIS
The GEOGRAPHY column on every listing enables radius and bounding-box queries in pure SQL. Vehicle taxonomy lives in three relational lookup tables.
Algolia
InstantSearch with 20+ facets: category, services, brands used, vehicle year ranges, rating, price range, and geo-radius. Results update in < 50 ms.
Mapbox GL
Custom dark map style with clustered listing pins, hover popups, scroll-spy highlighting, and flyTo animations. Style is DB-switchable from the admin console.
OpenAI
GPT-4o-mini powers Magic Fill (auto-complete listing details from a business name), natural language search parsing, and plain-English OBD code explanations.
Vercel
Every git push to main triggers an automatic deploy. Preview URLs are generated for every branch. The edge network caches public API routes globally.
Resend
Transactional email for listing inquiry notifications and password resets. Fire-and-forget so email failures never block a user action.
Tailwind CSS
Utility-first styling with a custom burnt-orange design system (#E05C1A primary), zinc dark-mode palette, and component classes in globals.css.
Framer Motion
The mobile bottom sheet uses spring physics with three snap points. Page transitions, the navbar menu, and map popups all use Motion for smooth UX.
GitHub
Source code is hosted on GitHub. Vercel's GitHub integration watches the main branch and deploys on every merge automatically.
shadcn/ui
Accessible, unstyled UI primitives (Sheet, Dialog, Button, Tabs) that are fully themed with the AutoGnome design tokens via CSS variables.
How a request travels
From your browser to the database and back — every layer explained.
Supabase
DB · Auth · Storage
Algolia
Search
OpenAI
AI
Mapbox
Maps
Resend
NHTSA API
Recalls
What powers what
Expand any feature to see how it works and which technologies are involved.
What we store, and where
Supabase (PostgreSQL)
- User accounts & profiles
- Listing data & photos
- Reviews & saved listings
- Inquiry messages
- Vehicle garage entries
- Analytics (views, clicks)
Algolia
- Public listing search index
- No personal user data
- Listing name, tags, location
- Synced from Supabase on publish
- Deleted when listing deactivated
Vercel
- Build artifacts & edge cache
- Environment variables (secrets)
- Request logs (30-day retention)
- No user data stored at edge
- GDPR-compliant infrastructure
OpenAI
- Listing details sent for Magic Fill
- OBD codes sent for explanation
- Search queries sent for NLP parse
- No data retained after response
- Ephemeral API calls only
Resend
- Inquiry notification emails
- Password reset emails
- Sender email & message body
- 30-day email log retention
- No marketing data collected
Third-Party APIs
- NHTSA vPIC — VINs sent for recall lookup
- Nominatim — addresses geocoded
- Mapbox — map tiles served to browser
- No data stored by AutoGnome
- All are one-way lookups
No black boxes. No mystery algorithms.
We believe businesses and drivers deserve to know exactly how the platform works. Every ranking signal, every data flow, every tool — documented here and kept up to date as the platform evolves.
Have a question about the stack?
Curious about a specific integration, a data decision, or a technical detail? Reach out.