MealScout

MealScout powers food truck, host, and restaurant discovery, bookings, and admin tools.

What's here

client/ - web app UI
server/ - API + background services
shared/ - database schema + shared types
scripts/ - ops and verification scripts
archive/docs/ - completed implementation/testing/launch docs (historical reference)

Active docs and maintenance

MASTER_PLAN.md - active planning and implementation context
ROUTES_MAP.md - route and flow reference
TEST_MANUAL_ONBOARDING.md - manual test and onboarding notes
BUILD_OUTPUTS.md - generated output directories and cleanup expectations
BACKEND_HOTSPOTS.md - current backend refactor seams and hotspot map
BACKEND_REFACTOR_PLAN.md - execution order and target file map for backend decomposition
docs/refactor/TWO_WEEK_EXECUTION_MAP_2026-04-15.md - concrete 2-week PR-by-PR execution map with file targets and verification commands
docs/refactor/REFACTOR_CYCLE_GUARDRAILS.md - active freeze policy and phase gate rules for the current refactor cycle
docs/refactor/REFACTOR_BOARD.md - queue/in-progress/merged/verified/rollback tracking board
docs/refactor/REFACTOR_METRICS_LOG.md - before/after reliability metrics log for each refactor merge
EMBED_CONTRACT.md and API_ACTIONS.md - TradeScout integration contracts; modify only through an explicitly reviewed compatibility or security change

Local prerequisites

Node.js 20-24
Git
Both node/npm and git available on your shell PATH

Quick start (dev)

npm install
npm run dev:server
npm run dev

Useful commands

npm run doctor
npm run check
npm run build
npm run test:flows:e2e

License MIT

Build trigger: 2026-02-08

Name		Name	Last commit message	Last commit date
.agents/skills/selective-intelligence		.agents/skills/selective-intelligence
.github		.github
.local/state/replit/agent		.local/state/replit/agent
.qa-evidence/host-route-native		.qa-evidence/host-route-native
.selective-intelligence/progress		.selective-intelligence/progress
.visual/captures		.visual/captures
.vscode		.vscode
android		android
archive/docs		archive/docs
artifacts		artifacts
attached_assets		attached_assets
audit_snapshot		audit_snapshot
client		client
docs		docs
evidence		evidence
ios		ios
logs		logs
migrations		migrations
packages/scout-blueprint		packages/scout-blueprint
playwright		playwright
scripts		scripts
server		server
shared		shared
test-assets		test-assets
vendor		vendor
.env.example		.env.example
.env.production.example		.env.production.example
.eslintrc.cjs		.eslintrc.cjs
.gitignore		.gitignore
.node-version		.node-version
.nvmrc		.nvmrc
.vercelignore		.vercelignore
ACCOUNT_AND_EVENT_NOTIFICATIONS.md		ACCOUNT_AND_EVENT_NOTIFICATIONS.md
ADMIN_STATS_INTEGRITY.md		ADMIN_STATS_INTEGRITY.md
AGENTS.md		AGENTS.md
API_ACTIONS.md		API_ACTIONS.md
BACKEND_HOTSPOTS.md		BACKEND_HOTSPOTS.md
BACKEND_REFACTOR_PLAN.md		BACKEND_REFACTOR_PLAN.md
BOOKING_PAYMENT_IMPLEMENTATION.md		BOOKING_PAYMENT_IMPLEMENTATION.md
BUILD_OUTPUTS.md		BUILD_OUTPUTS.md
CLEANUP_MAP.md		CLEANUP_MAP.md
CODEBASE_PATTERNS_OVERVIEW.md		CODEBASE_PATTERNS_OVERVIEW.md
CONTENT_FEED_VALIDATION.md		CONTENT_FEED_VALIDATION.md
DEAL_CONTRACT_VERIFICATION.md		DEAL_CONTRACT_VERIFICATION.md
DISPUTE_SYSTEM_IMPLEMENTATION.md		DISPUTE_SYSTEM_IMPLEMENTATION.md
EMBED_CONTRACT.md		EMBED_CONTRACT.md
HOST_DASHBOARD_UPDATE.md		HOST_DASHBOARD_UPDATE.md
INFINITY_SHADOW_ADAPTER.md		INFINITY_SHADOW_ADAPTER.md
KEEP_WARM_GUIDE.md		KEEP_WARM_GUIDE.md
MAP_GEOCODE_INTEGRITY.md		MAP_GEOCODE_INTEGRITY.md
MASTER_PLAN.md		MASTER_PLAN.md
MEALSCOUT_ACCOUNT_LIFECYCLE_DISCOVERY_AUDIT.md		MEALSCOUT_ACCOUNT_LIFECYCLE_DISCOVERY_AUDIT.md
MEALSCOUT_ADMIN_ACCOUNT_RECOVERY_AUDIT.md		MEALSCOUT_ADMIN_ACCOUNT_RECOVERY_AUDIT.md
MEALSCOUT_ADMIN_DASHBOARD_DECOMPOSITION_MAP.md		MEALSCOUT_ADMIN_DASHBOARD_DECOMPOSITION_MAP.md
MEALSCOUT_ADMIN_TRUTH_AUDIT.md		MEALSCOUT_ADMIN_TRUTH_AUDIT.md
MEALSCOUT_ADMIN_USER_AFFILIATE_MANAGEMENT_AUDIT.md		MEALSCOUT_ADMIN_USER_AFFILIATE_MANAGEMENT_AUDIT.md
MEALSCOUT_ADMIN_USER_MANAGEMENT_COMPLETENESS_AUDIT.md		MEALSCOUT_ADMIN_USER_MANAGEMENT_COMPLETENESS_AUDIT.md
MEALSCOUT_AFFILIATE_REFERRAL_CAPTURE_AUDIT.md		MEALSCOUT_AFFILIATE_REFERRAL_CAPTURE_AUDIT.md
MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_P2_ACCOUNTS_AND_SECRETS.md		MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_P2_ACCOUNTS_AND_SECRETS.md
MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_P3_RUNNER.md		MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_P3_RUNNER.md
MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_READINESS_GATE.md		MEALSCOUT_AUTHENTICATED_PRODUCTION_SMOKE_READINESS_GATE.md
MEALSCOUT_AUTH_ONBOARDING_ALIGNMENT_AUDIT.md		MEALSCOUT_AUTH_ONBOARDING_ALIGNMENT_AUDIT.md
MEALSCOUT_C7_OWNER_DASHBOARD_CONTEXT.md		MEALSCOUT_C7_OWNER_DASHBOARD_CONTEXT.md
MEALSCOUT_DE_RISK_ORDER.md		MEALSCOUT_DE_RISK_ORDER.md
MEALSCOUT_EMAIL_COPY_AUDIT.md		MEALSCOUT_EMAIL_COPY_AUDIT.md
MEALSCOUT_HANDOFF_SPINE.md		MEALSCOUT_HANDOFF_SPINE.md
MEALSCOUT_LAUNCH_BOARD_SQL_SAFETY_MAP.md		MEALSCOUT_LAUNCH_BOARD_SQL_SAFETY_MAP.md
MEALSCOUT_LOGIN_RECOVERY_AUDIT.md		MEALSCOUT_LOGIN_RECOVERY_AUDIT.md
MEALSCOUT_OWNER_DASHBOARD_DECOMPOSITION_MAP.md		MEALSCOUT_OWNER_DASHBOARD_DECOMPOSITION_MAP.md
MEALSCOUT_PARKING_PASS_DECOMPOSITION_MAP.md		MEALSCOUT_PARKING_PASS_DECOMPOSITION_MAP.md
MEALSCOUT_PAYMENT_WEBHOOK_SAFETY_MAP.md		MEALSCOUT_PAYMENT_WEBHOOK_SAFETY_MAP.md
MEALSCOUT_PRODUCTION_SMOKE_FIXTURE_PLAN.md		MEALSCOUT_PRODUCTION_SMOKE_FIXTURE_PLAN.md
MEALSCOUT_PUBLIC_AUTH_ROUTE_BOUNDARY_AUDIT.md		MEALSCOUT_PUBLIC_AUTH_ROUTE_BOUNDARY_AUDIT.md
MEALSCOUT_ROLE_ADMIN_DISPLAY_AUDIT.md		MEALSCOUT_ROLE_ADMIN_DISPLAY_AUDIT.md
MEALSCOUT_ROUTE_MAP.md		MEALSCOUT_ROUTE_MAP.md
MEALSCOUT_SEO_LLMO_LISAO_CANONICAL.md		MEALSCOUT_SEO_LLMO_LISAO_CANONICAL.md
MEALSCOUT_SIGNUP_ACCOUNT_TYPE_MAPPING_AUDIT.md		MEALSCOUT_SIGNUP_ACCOUNT_TYPE_MAPPING_AUDIT.md
MEALSCOUT_UI_DOCTRINE.md		MEALSCOUT_UI_DOCTRINE.md
MOBILE_RESPONSIVENESS_CLEANUP.md		MOBILE_RESPONSIVENESS_CLEANUP.md
MealScout_2026_Beta_Rep_Field_Packet_v10.pdf		MealScout_2026_Beta_Rep_Field_Packet_v10.pdf
MealScout_businesses_needing_review_2026-07-06.txt		MealScout_businesses_needing_review_2026-07-06.txt
OWNER_AI_ACTIONS.md		OWNER_AI_ACTIONS.md
PRIORITY_LIST.md		PRIORITY_LIST.md
README.md		README.md
ROUTES_MAP.md		ROUTES_MAP.md
TELEMETRY_SCHEMA.md		TELEMETRY_SCHEMA.md
TEST_MANUAL_ONBOARDING.md		TEST_MANUAL_ONBOARDING.md
TRADEDESCOUT_SSO.md		TRADEDESCOUT_SSO.md
VIDEO_TAB_SPEC.md		VIDEO_TAB_SPEC.md
WORKFLOW.md		WORKFLOW.md
admin_redesign_plan.md		admin_redesign_plan.md
api_raw_call_categorized.json		api_raw_call_categorized.json
api_raw_call_drift_report.json		api_raw_call_drift_report.json
api_raw_call_scan.txt		api_raw_call_scan.txt
api_raw_fetch_calls.txt		api_raw_fetch_calls.txt
batch.json		batch.json
capacitor.config.ts		capacitor.config.ts
components.json		components.json
decisions.json		decisions.json
deploy-north-star.ps1		deploy-north-star.ps1

Navigation Menu

Repository navigation

About

Repository files navigation

MealScout

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MealScout

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages