How dzuy/substrate works
Substrate is a mobile-first skincare intelligence app. The main user journey captures daily check-ins and photos, combines those inputs with profile and environmental context, then presents a Skin Story and a checklist-style daily plan. Users can also manage a product wardrobe and track progress; administrators manage the product catalog and users, and can ask Tate questions about catalog data. The README documents the major capabilities, while source excerpts and the index support only some implementation links; unverified subsystem relationships are omitted.
Main entry points: app App screens · supabase.ts Supabase client · handler.mjs Face Scan handler · catalog.ts Product catalog service
Components 33
Skincare app
- App screens
src/app - Sign-in screen
src/components/auth-screen.tsx - Session context
src/lib/auth-context.tsx - Authentication
src/services/auth.ts - Daily data services
src/services - Data model
src/types/database.ts - Supabase client
src/lib/supabase.ts - Supabase
Skin intelligence
- Photo analysis
supabase/functions/analyze-photo/index.ts - Product analysis
supabase/functions/analyze-products/index.ts - Skin Story engine
src/skin-intelligence/skinStoryEngine.ts - Story rules
src/skin-intelligence/skinStoryRules.ts - Today Plan engine
src/skin-intelligence/todayPlanEngine.ts - Recommendations
src/services/recommendations.ts - Progress summary
supabase/functions/generate-progress-summary/index.ts - Recommendation function
supabase/functions/generate-recommendation/index.ts
Product catalog
- Skin Wardrobe
src/app/skin-wardrobe.tsx - Product catalog service
src/services/catalog.ts - Catalog CMS service
src/services/catalog-cms.ts - Catalog pagination
src/services/catalog-pagination.ts
Administration
- Catalog workspace
src/components/admin/catalog-workspace.tsx - User administration
src/services/admin-users.ts - Ask Tate drawer
src/components/admin/ask-tate-drawer.tsx - Ask Tate server
server/ask-tate.mjs - Production server
server/production.mjs
Face Scan Lab
- Face Scan Lab UI
prototypes/face-scan/public/app.js - Face Scan handler
prototypes/face-scan/handler.mjs - Analysis providers
prototypes/face-scan/providers.mjs - Assessment questions
prototypes/face-scan/public/questions.mjs - Lab catalog lookup
prototypes/face-scan/catalog/database.mjs
Other components
- User
- Administrator
- OpenAI
Connections 40
- User → Sign-in screen: signs in
src/components/auth-screen.tsx - Sign-in screen → Authentication: submits credentials
src/components/auth-screen.tsx - Session context → Supabase client: reads session
src/lib/auth-context.tsx - Authentication → Supabase client: authenticates
src/services/auth.ts - User → App screens: uses
README.md - App screens → Daily data services: records daily inputs
src/app/index.tsx - Daily data services → Supabase client: reads and writes
src/services/auth.ts - Supabase client → Supabase: connects to
README.md - App screens → Photo analysis: requests photo analysis
- App screens → Skin Story engine: produces Skin Story
- Skin Story engine → Story rules: uses rules
src/skin-intelligence/skinStoryEngine.ts - App screens → Today Plan engine: generates daily checklist
- Today Plan engine → Story rules: uses state labels
src/skin-intelligence/todayPlanEngine.ts - App screens → Recommendations: loads recommendations
- Recommendations → Skin Story engine: uses engine
src/services/recommendations.ts - Recommendations → Today Plan engine: uses engine
src/services/recommendations.ts - Recommendations → Supabase client: reads and writes
src/services/recommendations.ts - App screens → Progress summary: requests progress summary
- App screens → Recommendation function: requests recommendation
- User → Skin Wardrobe: manages products
README.md - Skin Wardrobe → Product catalog service: loads catalog
src/app/skin-wardrobe.tsx - Product catalog service → Catalog pagination: collects pages
src/services/catalog.ts - Product catalog service → Supabase client: queries catalog
src/services/catalog.ts - Administrator → Catalog workspace: manages catalog
README.md - Catalog workspace → Product catalog service: loads product data
src/components/admin/catalog-workspace.tsx - Catalog workspace → Catalog CMS service: loads and saves CMS data
src/components/admin/catalog-workspace.tsx - Catalog CMS service → Product catalog service: uses catalog service
src/services/catalog-cms.ts - Administrator → User administration: manages accounts
README.md - Administrator → Ask Tate drawer: asks catalog questions
README.md - Ask Tate drawer → Ask Tate server: sends chat request
README.md - Ask Tate server → Supabase: retrieves catalog records
README.md - Ask Tate server → OpenAI: generates answers
README.md - Production server → Ask Tate server: routes requests
server/production.mjs - User → Face Scan Lab UI: tries lab prototype
README.md - Face Scan Lab UI → Face Scan handler: submits analysis
- Face Scan handler → Analysis providers: creates providers
prototypes/face-scan/handler.mjs - Face Scan handler → Assessment questions: uses assessment questions
prototypes/face-scan/handler.mjs - Face Scan handler → Lab catalog lookup: loads catalog
prototypes/face-scan/handler.mjs - Production server → Face Scan handler: routes requests
server/production.mjs - Analysis providers → OpenAI: uses AI provider