# Management — Content Source of Truth This folder is the **single source of truth** for all editable content, media, and configuration. Developers and content managers should edit files here — **never hardcode content in TypeScript/React source files**. --- ## Directory Structure ``` management/ ├── README.md ← This file │ ├── apps/ ← Per-app media & promotional assets │ ├── art-studio-app/ │ │ └── media/ ← Screenshots, icons, feature graphics │ ├── bg-cleaner-app/ │ │ └── media/ │ ├── photo-enhancer-pro/ │ │ └── media/ │ └── portrait-app/ │ └── media/ │ ├── pages/ ← Per-page layout config & media │ │ │ ├── home/ ← Homepage (/) │ │ ├── page.config.json ← Section order, props, copy, SEO │ │ ├── media/ ← Global homepage media assets │ │ │ ├── hero/ ← Hero section images / videos │ │ │ ├── reel/ ← Transformation reel media │ │ │ ├── showcase/ ← Showcase grid images │ │ │ └── our-tools/ ← Per-tool images for the grid │ │ │ └── {tool-slug}/ │ │ └── sections/ ← Per-section override media │ │ ├── hero/media/ │ │ ├── how-it-works/media/ │ │ ├── our-tools/ ← Tool thumbnails per grid slot │ │ ├── community-reviews/ │ │ └── trendy-bento/ │ │ │ ├── apps/ ← Apps listing page (/apps) │ │ └── media/ │ │ │ ├── tools/ ← Tools index + per-tool pages │ │ ├── page.config.json ← /tools index page section config │ │ └── {tool-slug}/ ← One directory per published tool │ │ ├── tool.config.json ← Tool-level page overrides (optional) │ │ └── media/ ← Before/after comparison images │ │ ├── before.jpg │ │ └── after.jpg │ │ │ └── trust/ ← Trust & Privacy page (/trust) │ ├── page.config.json │ └── media/ │ └── templates/ ← Blank JSON templates for new content ├── app.json ← Starter for a new app entry └── tool.json ← Starter for a new tool entry ``` --- ## Content Files vs Management Files | Data type | Location | Purpose | |-----------|----------|---------| | Site-wide config | `content/site.config.json` | Nav, footer, theme, features, SEO, org schema | | Tool metadata | `content/collections/tools/*.json` | Tool data, tryIt config, SEO, schema | | App metadata | `content/collections/apps/*.json` | App data, store links, features | | Category data | `content/collections/categories/*.json` | Category labels and slugs | | Homepage layout | `management/pages/home/page.config.json` | Section order, all copy, CTAs | | Tool page layout | `management/pages/tools/{slug}/tool.config.json` | Per-tool page overrides | | Media / images | `management/pages/{page}/media/` | Before/after, hero, reel images | | Feature configs | `content/features/*.json` | Auto-mask, rate-limits, cookies, reviews | | Localisation | `content/locales/*.json` | Translated strings per locale | --- ## Feature Configs (`content/features/`) | File | Controls | |------|---------| | `auto-mask.config.json` | Auto-mask ellipse size, resolution (512×512), subject/background RGBA | | `rate-limits.config.json` | Per-visitor/IP/daily API quota limits and dev overrides | | `cookie.config.json` | Visitor cookie max-age (days) and session cookie max-age | | `api-proxy.config.json` | Max upload size (MB), request timeout (ms), max image dimension | | `reviews.json` | Community review cards shown in the marquee on the homepage | --- ## Workflow: Editing Homepage Content 1. Open `management/pages/home/page.config.json` 2. Find the section to edit by its `type` field (e.g. `hero`, `faq`, `reviewsMarquee`) 3. Edit the `props` object — all copy, CTAs, and configuration live here 4. For images: drop files in the matching `media/` subdirectory and update the path in `props` 5. Run `npm run dev` to preview — **no code changes required** --- ## Workflow: Editing Community Reviews 1. Open `content/features/reviews.json` 2. Add, edit, or remove entries in the `reviews` array 3. Each entry needs: `name`, `role`, `location`, `avatarInitials`, `avatarColor`, `body`, `tool`, `stars` 4. The homepage marquee automatically picks up the new data on next page load --- ## Workflow: Adding a New Tool 1. Copy `management/templates/tool.json` → `content/collections/tools/{slug}.json` 2. Create `management/pages/tools/{slug}/` directory 3. Add before/after images to `management/pages/tools/{slug}/media/` 4. Register the endpoint in `content/api.catalog.json` 5. The tool appears automatically on `/tools` and `/tools/{slug}` — no code changes --- ## Workflow: Adding a New App 1. Copy `management/templates/app.json` → `content/collections/apps/{slug}.json` 2. Create `management/apps/{slug}/media/` directory 3. Add app media (icon, screenshots, feature graphic) to that directory 4. The app appears automatically on `/apps` and `/apps/{slug}` — no code changes --- ## Workflow: Adjusting Rate Limits 1. Open `content/features/rate-limits.config.json` 2. Update `perVisitorPerDay`, `perIpPerHour`, or `dailyBudgetCalls` 3. Dev overrides (loopback only) are in `devOverrides` 4. Restart the server to pick up the new values (cached at startup) --- ## Conventions > [!IMPORTANT] > **Never hardcode** strings, URLs, or image paths in `.tsx`/`.ts` source files. | What | Where | |------|-------| | Copy / labels / CTAs | `page.config.json` props or `content/` JSON | | Images / videos | `management/` directories, referenced by path in JSON | | Feature toggles | `content/site.config.json` → `features` block | | API secrets / keys | `.env.local` only — **never** in JSON files | | Org schema data | `content/site.config.json` → `organization` block | | Rate limits | `content/features/rate-limits.config.json` | | Cookie expiry | `content/features/cookie.config.json` | | Auto-mask params | `content/features/auto-mask.config.json` | --- ## Schema Versions | File | `schemaVersion` | Last updated | |------|-----------------|--------------| | `content/site.config.json` | 1.0 | 2026-11 | | `content/collections/tools/*.json` | (per file) | varies | | `content/collections/apps/*.json` | (per file) | varies | | `management/pages/home/page.config.json` | (implicit) | 2026-11 |