Everything San Marcos
A hyper-local business directory, interactive map, community calendar, and advertising platform serving 85,600+ San Marcos residents — with a magic-link Owner Studio, Stripe fulfillment, and a Meta Graph API publisher.
The opportunity
A local Facebook group had grown past 85,000 members, and local businesses wanted to reach them. The problem was that "wanting to advertise" and "being able to advertise" are different things — someone has to handle the inquiry, agree the placement, take the payment, and collect the creative.
The first version of Everything San Marcos solved that with a self-service advertising funnel. Version 2.0 went further: the site stopped being a landing page for ads and became the thing locals actually use — a searchable directory of 245+ verified businesses, an interactive neighborhood map, and a community events calendar.
That shift matters commercially. A directory earns repeat visits, and repeat visits are what make an ad placement worth buying.
Directory, map, and business profiles
The home page is a split-screen workspace: listings on one side, a Leaflet map on the other. Businesses carry one or two categories, a neighborhood, a coupon, and optional card styling, and the map pins stay in sync with whatever the filters currently show.
Each business also gets a real profile page at /business/:id — server-rendered with Open Graph and Twitter metadata plus JSON-LD LocalBusiness schema, so a listing is legible to search engines and to LLM crawlers rather than only to a browser running JavaScript.
Business logos are resized on the fly at /api/registry/:id/logo using sharp, with WebP negotiation and an LRU cache. The earlier approach inlined base64 payloads into the page, which made the directory heavy as the listing count grew.
Owner Studio and the card designer
The hardest part of running a directory is not building it — it's keeping 245 listings accurate without doing the data entry yourself. So owners do it, through a magic-link portal at /manage.html with no passwords to manage.
Owners of seeded businesses can claim their listing. If the email matches, the claim auto-approves and mints a 30-day link immediately; otherwise it routes to an admin claims queue. Approving a new submission mints and emails the owner's first link automatically.
A $7/month Listing Boost unlocks the Design Studio: gradient and radial card backgrounds, borders, ambient glow, display fonts, four typography colour pickers with synced hex inputs, one-click auto-match text contrast, weekly announcements, and photo galleries. There's a ?demo=1 sandbox so the whole thing can be tried before paying.
Community calendar and feed ingestion
The calendar at /calendar.html offers month, week, list, and map views. The map is deliberately strict: only events with verified coordinates get pinned, and user-submitted street addresses are geocoded through Nominatim rather than guessed.
Populating a local calendar by hand doesn't scale, so an ingestor syncs external .ics and RSS/Atom feeds every six hours — Visit San Marcos events, regional sports schedules, and similar sources — with upserts and per-feed health tracking so a broken source is visible instead of silently empty.
Advertising, Stripe, and Facebook publishing
Advertising still runs on the original principle: capture the ad details before payment and forward them as Stripe session metadata, so the payment record and the creative arrive together instead of as a follow-up email chain.
| Package | Price | What it is |
|---|---|---|
| Single Group Post | $14 | One promotional post in the group — photos, video, links, and a phone CTA. Buy 1–10 post credits at once. |
| FB Ad Post + Promoted | $49 | One-time: the post plus pinned Featured placement at the top of the group for 7 days, with a 30-day Directory Boost and Gold Map Pin. |
| Monthly Sponsor | $149/mo | Four promoted posts a month, permanent Community Spotlight and Gold Map Pin, and full Owner Design Studio access. |
| Annual Sponsor | $1,252/yr | 48 promoted posts a year, year-round Featured Spotlight and Gold Map Pin — 30% off monthly, saving $536. |
| Listing Boost | $7/mo | Directory and map priority only — custom card theme, Gold Pin, announcements, and photo galleries. |
Fulfilment is where the platform earns its keep. A Meta Graph API bridge exchanges the Business System User token for a Page-scoped access token, publishes the sponsor ad to the official Facebook Page, decrements the buyer's post credits, and opens the live post for one-tap sharing into the 85,600-member group.
Receipts are itemised HTML delivered through the Brevo API with a mandatory admin BCC, and webhook handling covers checkout completion, invoice payment failure, and subscription cancellation — a monthly sponsorship has to actually stop when it stops being paid for.
Admin OS
Everything above needs an operator surface, and a directory generates a lot of small decisions: approve this listing, review this claim, fix this event, adjust this price. The admin at /admin.html is a single-workspace command centre rather than a set of scattered pages.
- Compact KPI strip and a Quick Actions bar for the jobs done most often.
- Three-column business management grid with logo upload and card rendering.
- Two-column events and feeds workspace, including per-feed health.
- Claims queue, category manager, and a package / payment-link builder.
- Focused OS and Expandable Stack modes, plus a mobile slide-over drawer.
Performance, security, and analytics
The site is a single Node process serving static assets, so the cheap wins are worth taking: JavaScript and CSS are minified in memory with esbuild and served with ETags and a one-year cache header, which turns repeat visits into 304s.
- Nonce-based Content-Security-Policy, HSTS, Permissions-Policy, and X-Frame-Options: SAMEORIGIN.
- PII stripped from the public directory payloads.
- Google Tag Manager deferred off the critical path until post-load idle or first interaction, and disclosed in the privacy policy.
- Server-rendered
/llms.txt,/sitemap.xml, and evergreen local pages such as/san-marcos-weekendand/san-marcos-guide.
The visual language is a custom "San Marcos River Luxe" system — river teal and deep ink, built to feel like San Marcos rather than like a generic ad directory. Local advertising is a trust business, and a site that looks like every other template doesn't earn trust from a business deciding whether to spend $149 a month.