# SK Shreds — app context and build guide

Last updated: 13 September 2026

## What SK Shreds is

SK Shreds is a mobile-first **SK 100** course: a practical, self-paced 100-day training system. Members train through assigned course days, use practical nutrition support, learn the movements used in the course, and see simple personal progress.

It is intentionally a focused product, not a large gym-membership app. The commercial direction is a **single £5 purchase for the full course**, not a recurring subscription. Do not introduce subscription tiers, a generic gym timetable, or unrelated lifestyle features unless the owner asks.

## Approved navigation and routes

The app has four primary areas. Keep this bottom navigation small, fixed, and in this order:

1. **Train** — `/` and `/workout/today`
2. **Nutrition** — `/nutrition`
3. **Vault** — `/exercises`
4. **Progress** — `/progress`

The profile button is at top right and opens `/settings`. There is no AI Coach in the approved product and it must not be reintroduced.

## Train rules

- The member sees one current SK 100 course day, based on their saved profile.
- “Start session” opens that assigned day. Starting the same day again must not advance the course or create duplicate progression.
- A completed, verified session advances the saved course day.
- Do not show an estimated workout duration in the app UI. Indoor and outdoor work take different amounts of time.
- Show actual assigned training blocks and movements from the course data. Do not invent workout prescriptions.
- A return-after-missed-days message may be shown only when it is relevant. Do not show “Your course, your pace” by default.

## Nutrition rules

- Nutrition has two clear modes: **Today’s Fuel** and **Healthy Facts**.
- Today’s Fuel uses the member’s saved calorie and macro targets plus real meal catalogue data.
- Healthy Facts are researched, practical facts — not motivational slogans, inspirational quotes, or miracle claims.
- Each healthy fact must keep a link to its original, reputable guidance or research source.
- Facts currently cover topics such as magnesium, fibre, vitamin D, hydration, fruit and vegetables, salt, creatine, and post-workout skin care.

## Exercise Vault rules

- Show only movements that belong to the SK 100 course.
- Do not use difficulty labels as the main navigation concept.
- Approved groups are: Calisthenics, Strength, Kettlebell, Mobility, Athletic Training, and Recovery.
- Kettlebell should use the full available kettlebell library, not repeat Kettlebell Swing across many course days.
- Exercise details should use the approved technique, cues, artwork/video, and prescription from the exercise data.

## Progress rules

- Keep progress clear and human: course day, training days, a seven-day consistency view, next milestone, and an optional personal check-in.
- Do not add a live weight chart to this simplified course screen by default.
- The check-in is personal reflection, not a score.
- Course state for signed-in members is saved server-side. It should remain correct across devices.

## Data that is safe to read publicly

These files are live sources of app content:

- `/daily-plans.json` — course days, active day, categories, and prescribed movement slugs.
- `/exercise-library.json` — exercise names, categories, steps, cues, assets, and movement metadata.
- `/meal-catalog.json` — approved meal plans, macros, ingredients, and meal information.

Member identity, authentication sessions, server secrets, payment credentials, and private profile data are not public and must never be added to these documents.

## Interaction design

- Target is mobile first. The main app column is intentionally compact and centred on larger screens.
- Use a black / near-black base, warm off-white text, and SK orange (`#FF622C`) as the primary action colour.
- Blue is reserved for the Exercise Vault and source-linked Healthy Facts; do not turn the entire interface blue.
- Use bold, tight, uppercase display headlines; use a clean sans-serif for body copy and controls.
- Cards should feel purposeful: clear status, clear action, subtle glow/gradient, small motion on press or section entry.
- Keep transitions short. Navigation must never show raw code, a blank screen, or a legacy page flicker.
- Keep one obvious primary action per screen. Avoid duplicate actions, oversized menus, and extra floating coach buttons.

## What to preserve when making changes

- The four-route navigation above.
- One-course-day progression model.
- Source-linked factual Healthy Facts.
- Real course, exercise, and meal data instead of placeholder data.
- Account-backed course state for signed-in members.
- The dark SK Shreds visual identity and orange primary actions.

When a request conflicts with this guide, ask the SK Shreds owner before changing product scope.