6.9 KiB
6.9 KiB
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
- Open
management/pages/home/page.config.json - Find the section to edit by its
typefield (e.g.hero,faq,reviewsMarquee) - Edit the
propsobject — all copy, CTAs, and configuration live here - For images: drop files in the matching
media/subdirectory and update the path inprops - Run
npm run devto preview — no code changes required
Workflow: Editing Community Reviews
- Open
content/features/reviews.json - Add, edit, or remove entries in the
reviewsarray - Each entry needs:
name,role,location,avatarInitials,avatarColor,body,tool,stars - The homepage marquee automatically picks up the new data on next page load
Workflow: Adding a New Tool
- Copy
management/templates/tool.json→content/collections/tools/{slug}.json - Create
management/pages/tools/{slug}/directory - Add before/after images to
management/pages/tools/{slug}/media/ - Register the endpoint in
content/api.catalog.json - The tool appears automatically on
/toolsand/tools/{slug}— no code changes
Workflow: Adding a New App
- Copy
management/templates/app.json→content/collections/apps/{slug}.json - Create
management/apps/{slug}/media/directory - Add app media (icon, screenshots, feature graphic) to that directory
- The app appears automatically on
/appsand/apps/{slug}— no code changes
Workflow: Adjusting Rate Limits
- Open
content/features/rate-limits.config.json - Update
perVisitorPerDay,perIpPerHour, ordailyBudgetCalls - Dev overrides (loopback only) are in
devOverrides - Restart the server to pick up the new values (cached at startup)
Conventions
Important
Never hardcode strings, URLs, or image paths in
.tsx/.tssource 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 |