MindPalaceX · The Workshop
The Idea Wall →

On the Idea Wall · ▲ 0 votes

ResourceReach — the spec

ResourceReach is a client portal that helps everyday people find, evaluate, and contact verified community resources near them. A resident looking for food assistance, mental health support, housing help, or any other local service can search by category, filter by distance, read peer reviews, and reach a provider in seconds — no phone trees, no dead links, no guesswork.

---

Decisions locked

QuestionAnswer
ShapeClient portal
AudienceEveryday consumers seeking community services
Core loopSearch by resource category → filter by proximity → browse verified listings → contact or save
Must-have count5 features, defined below
v1 success metric10 weekly active users by day 30

---

The core loop

  1. User opens the portal and selects a resource category (e.g., food, housing, mental health).
  2. User sets a proximity filter — ZIP code or current location — to narrow results to nearby providers.
  3. Results display verified listings showing name, hours, eligibility requirements, and aggregate rating.
  4. User reads peer reviews to assess fit, then taps a direct contact button: call, email, or get directions.
  5. User bookmarks the provider into a named folder (e.g., "Food Banks," "For Mom") for future reference.

---

v1 scope

Search by resource category and proximity filter
A search bar paired with category tiles (food, housing, health, legal, etc.) and a distance slider or ZIP input. Lives on the Home/Search screen; returns a ranked list of matching providers.

Direct contact buttons: call, email, or directions
Each listing card surfaces three one-tap actions — initiate a phone call, open a pre-addressed email, or launch navigation. Lives on the Provider Detail screen; removes every friction point between a user and a resource.

User reviews and ratings
Authenticated users submit a star rating and short text review for any provider they've contacted. Aggregate score and individual reviews display on the Provider Detail screen to help others make informed decisions.

Save and organize bookmarked resources into folders
A bookmark icon on every listing lets users save providers; a Saved Resources screen lets them create, rename, and sort folders. Ensures users can return to vetted options without repeating their search.

Verified provider listings with hours and eligibility
Each listing carries a verified badge, confirmed operating hours, and plain-language eligibility criteria (e.g., "Residents of Cook County; must show ID"). Managed via an admin intake flow; displayed prominently on the Provider Detail screen.

---

Deliberately later

  • Real-time availability and waitlist status — requires live data feeds or provider-side integrations; sustainable only after a critical mass of partner providers is established.
  • Personalized recommendations based on saved history — meaningful signal requires enough user history to train on; v2 once retention data exists.
  • Offline access to saved resource details — service-worker caching adds architectural complexity; validates only after users demonstrate they rely on the app in low-connectivity settings.

---

Data model sketch

  • users — id, name, email, phone, location (lat/lng or ZIP), created_at
  • providers — id, name, category, address, lat, lng, phone, email, hours (JSON), eligibility_text, verified (bool), created_at
  • reviews — id, user_id, provider_id, rating (1–5), body, created_at
  • bookmarks — id, user_id, provider_id, folder_id, created_at
  • folders — id, user_id, name, created_at
  • categories — id, label, icon_slug
  • contact_events — id, user_id, provider_id, contact_type (call/email/directions), timestamp

---

Screens

  • Home / Search — category tiles and search bar; entry point for every session.
  • Results List — filtered, proximity-ranked provider cards with rating and distance.
  • Provider Detail — full listing: hours, eligibility, contact buttons, reviews, bookmark action.
  • Leave a Review — star selector and text field; submits to Provider Detail.
  • Saved Resources — folder list with nested bookmarks; create and rename folders.
  • Account / Profile — login, location preferences, review history.
  • Admin / Provider Intake (internal) — form for verifying and updating provider records.

---

How to use this document

  • Bring it into Mind Palace; the guided platform and its AI coach pick up from exactly this document and build ResourceReach with you step by step.
  • Hand it to a developer as the complete v1 brief — scope, data model, and screens are defined; no additional discovery required before work begins.
  • Keep it as the single source of truth while you build, so every feature decision traces back to a deliberate choice made here.

This is Barrington's. Build yours.

A spec like this is step 3 of Mind Palace's nine — the other six take a weekend: working software, a real offer, first customers.

Want to build this with Barrington?

Tell us who you are and we'll broker the introduction — their contact details stay private until they say yes.