# BeddyColor - Full Site Description

BeddyColor is a Nuxt-based, multilingual coloring page website focused on free printable pages for children, families, and educators. The current site experience centers on browsing by category and age, opening a preview modal from each card, printing directly, downloading images, and reading a small but real blog section.

## Core Purpose

- Provide free printable coloring pages with a simple browsing experience.
- Help parents and teachers quickly find age-appropriate themes.
- Support screen-free creative activities with print and download actions.
- Offer SEO-friendly themed landing pages across categories, subtopics, and ages.

## Main Public Routes

### Homepage
- **`/`**
- Presents the BeddyColor brand, featured categories, new arrivals, FAQ content, and calls to action.
- Promotes printable PDFs and easy navigation, although the card interaction is currently modal-based rather than a dedicated detail-page flow.

### Category Directory
- **`/categories`**
- Lists the main coloring themes.
- Includes a popular pages section fed by backend data and editorial-style introduction content.

### Category Landing Pages
- **`/categories/[category]`**
- Each category page introduces the theme, shows related subtopics, and loads coloring cards with infinite scrolling.
- Related category recommendations appear at the bottom of the page.

### Topic Collections
- **`/categories/[category]/[subcategory]-coloring-pages`**
- These are the main collection pages for specific subjects.
- Each topic page includes a heading, description, breadcrumb navigation, card grid, and additional sibling topics.
- Current content examples include dinosaurs, farm animals, wild animals, ocean animals, unicorns, the Monkey King, Christmas, Halloween, Fall, Spring Festival, Mid-Autumn Festival, Dragon Boat Festival, Lantern Festival, Children's Day, alphabet, numbers, and shapes.

### Age-Based Collections
- **`/age/toddler-coloring-pages`**
- **`/age/preschool-coloring-pages`**
- **`/age/kids-coloring-pages`**
- These pages explain why the collection fits the age group, list developmental benefits, and load relevant coloring pages with infinite scroll.

### Blog
- **`/blog`**
- **`/blog/[slug]`**
- The blog section is implemented with Nuxt Content.
- It currently includes at least one published post: **How to use Beddy Color**.
- The blog index supports title search and the detail page renders markdown content.

### Company Pages
- **`/company/about`**
- **`/company/faq`**
- **`/company/contact`**
- **`/company/privacy`**
- **`/company/terms`**
- These pages cover brand story, frequently asked questions, contact flow, and policy information.

## Taxonomy and Content Organization

### Main Categories
- **Animals**
- **Fantasy**
- **Cartoons**
- **Holidays**
- **Educational**
- **Vehicles**

### Notable Subtopics

#### Animals
- Dinosaur coloring pages
- Farm animal coloring pages
- Wild animal coloring pages
- Ocean animal coloring pages

#### Fantasy
- Unicorn coloring pages

#### Classic Stories
- Monkey King coloring pages

#### Holidays
- Spring Festival coloring pages
- Mid-Autumn Festival coloring pages
- Dragon Boat Festival coloring pages
- Lantern Festival coloring pages
- Children's Day coloring pages
- Christmas coloring pages
- Halloween coloring pages
- Fall coloring pages

#### Educational
- Alphabet coloring pages
- Number coloring pages
- Shape coloring pages

#### Vehicles
- Cars
- Trucks
- Emergency vehicles
- Construction vehicles
- Trains
- Airplanes
- Boats
- Motorcycles
- Bicycles

### Age Groups
- **Toddler (0-3)**: large spaces, simple outlines, beginner-friendly sheets.
- **Preschool (4-6)**: playful educational themes such as letters, numbers, and familiar objects.
- **Kids (7-12)**: more detailed pages designed for longer creative sessions and stronger focus.

## Actual User Interactions Implemented

### Coloring Card Actions
The coloring cards are the primary interaction surface across the homepage, category pages, topic pages, and age pages.

- **Preview modal**: clicking the image opens a larger in-page preview.
- **Print**: printing is triggered from the card or modal and opens a print-friendly image flow in an iframe.
- **Download**: downloads use the site's `/api/download` proxy flow to reduce cross-origin issues.
- **Pinterest sharing**: users can open a Pinterest share intent using the current page URL and image URL.

### Navigation
- Desktop and mobile navigation are implemented.
- The main visible navigation focuses on home, categories, age collections, and company pages.
- The footer also links into featured collections such as popular and new pages.
- Language switching is available from the header.

### Search and Filtering
- The homepage search UI is currently commented out.
- The blog index supports text search by title.
- Topic pages contain a difficulty filter structure in code, but the filter UI is currently commented out.

## Dynamic Data and Content Sources

- Main category lists come from `/api/categories`.
- Topic lists come from `/api/topics`.
- Coloring page card grids are populated through backend service calls in the app's API service layer.
- Blog content is stored in `content/blog`.
- The public site content is currently strongest in the category, topic, age, and blog areas.

## Important Route Status Notes

The repository contains some public routes that are not yet full destination experiences. These should be treated as placeholders or generic fallbacks rather than mature content hubs.

- **`/coloring/[id]`**: placeholder detail page.
- **`/[slug]`**: generic single-segment placeholder route.
- **`/[topic]-coloring-pages`**: generic collection placeholder route.
- **`/resources/[slug]`**: placeholder resource route.
- **`/tools/[slug]`**: placeholder tool route.
- **`/featured/[slug]`**: partially themed page exists, but it is more generic than the main category and topic system.

## Audience

- Parents looking for free printable activities
- Teachers and classrooms needing simple print-ready art sheets
- Children who want themed coloring content by interest or age
- Families seeking calm, offline creative time

## Tone and Positioning

- Friendly and family-oriented
- Bright, playful, and print-focused
- Structured for SEO discovery around coloring themes and age groups
- Positioned as a free, accessible coloring resource rather than a paid subscription product