You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 3f6f97e
Browse filesBrowse the repository at this point in the historyBrowse files
# CodingCat.dev Cursor & IDE Rules (`.cursorrules`)
2
2
3
-
Always read and follow `AGENTS.md`, `GEMINI.md`, and `DESIGN.md` at the root of this repository before generating code, copy, or visual prompts.
3
+
Always follow `AGENTS.md`and `DESIGN.md`:
4
4
5
-
## Critical Rules Summary
6
-
1. NEVER use em-dashes anywhere in prose, UI copy, titles, comments, or documentation. Use commas, parentheses, colons, or separate sentences.
7
-
2. ALWAYS use Markdown tables for comparisons between tools, frameworks, architectures, or trade-offs.
8
-
3. Follow the 13-module CodingCat.dev Design System in `skills/codingcat-design-system/`, `skills/alex-voice-and-copy/`, and `skills/codingcat-media-studio/`:
9
-
- Colors: Canvas Obsidian `#0F172A`, Pure Void `#000000`, Surface Slate `#1E293B`, Elevated `#334155`, Royal Purple `#4B2E83`, Soft Lavender `#B4A7D6`, Electric Lime `#C5E86C`, Mint `#86EFAC`, Coral `#FCA5A5`, Text Primary `#F8FAFC`, Text Muted `#94A3B8`.
10
-
- Typography: `Nunito` (800/900) for chunky H1 display titles, `Inter` for UI and H2-H6, `JetBrains Mono` for code/badges, and `Virgil` / `Excalifont` for dark-mode Excalidraw diagram explanations.
11
-
- Mascot Assets: Use canonical files in `assets/` (`AJHeadphones.png`, `AJ-2D-Bipedal.jpg`, `AJ-3D-Headphones-Front.jpg`, `AJ-3D-Headphones-Left.jpg`, `AJ-3D-Headphones-Right.jpg`).
5
+
1. **Canonical Content Pillars & Terminology**:
6
+
- **Courses** (`/courses` -> `/course/[slug]`), made of **Lessons** (`Explore Courses →`, `Start Course →`).
7
+
- **Podcasts** (`/podcasts` -> `/podcast/[slug]`), made of **Episodes** (`Watch Podcasts`, `Watch Episode →`).
8
+
- **Blog** (`/blog` -> `/post/[slug]`), made of **Blog Posts** (`Read Blog`, `Read Post →`).
9
+
- **Diagrams**: Never write the brand word `"Excalidraw"` in user-facing UI copy, badges, filenames, or captions; call them **Diagrams**, **Visual Diagrams**, or **Architecture Diagrams**. Never invent synonyms like `"Teardowns"`, `"Blueprints"`, `"Curriculum"`, `"Units"`, or `"Skill Trees"`.
10
+
2. **NEVER Use Em-Dashes**: Do not output the em-dash character anywhere.
11
+
3. **Always Use Tables for Comparisons**: Render Markdown or HTML comparison tables.
12
+
4. **Header & Mobile 3-Line Drawer**: Never put a `"Get Started"` button inside `#site-header`; keep the mobile header clean so `#nav-drawer-toggle` (the 3-line menu button) is always visible.
Copy file name to clipboardExpand all lines: AGENTS.md
+28-24Lines changed: 28 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,15 +8,26 @@ This repository contains both the **CodingCat.dev Monorepo** (`apps/site`, `apps
8
8
9
9
## 1. Non-Negotiable Global Rules
10
10
11
-
1.**NEVER Use Em-Dashes**: Never output the em-dash character in any prose, UI copy, markdown document, title, video script, social post, or code comment. Use commas, parentheses, colons, or separate sentences instead.
12
-
2.**Always Use Markdown Tables for Comparisons**: Whenever comparing tools, frameworks, architectures, pricing, or trade-offs, always render a structured Markdown or HTML comparison table.
13
-
3.**Dark-Mode-First Visual System**: CodingCat.dev is strictly dark-mode-first. Use Canvas Obsidian (`#0F172A`) for page backgrounds, Pure Void (`#000000`) for Excalidraw diagram wells, Surface Slate (`#1E293B`) for cards, CodingCat Royal Purple (`#4B2E83`), Soft Lavender (`#B4A7D6`), and Electric Lime Green (`#C5E86C`) for primary CTAs and focus rings.
- Our 3 content pillars match our Sanity document types:
13
+
-**Courses** (`/courses` -> `/course/[slug]`), made of **Lessons** (CTA: `Explore Courses →` or `Start Course →`).
14
+
-**Podcasts** (`/podcasts` -> `/podcast/[slug]`), made of **Episodes** (CTA: `Watch Podcasts` or `Watch Episode →`).
15
+
-**Blog** (`/blog` -> `/post/[slug]`), made of **Blog Posts** (CTA: `Read Blog` or `Read Post →`).
16
+
-**Never invent synonyms** like `"Teardowns"`, `"Blueprints"`, `"Curriculum"`, `"Units"`, `"Boss Node"`, or `"Skill Trees"`.
17
+
-**Never write the brand word `"Excalidraw"` in user-facing UI copy**, badges, headings, filenames, or captions. Always refer to them simply as **Diagrams**, **Visual Diagrams**, or **Architecture Diagrams** in user-facing text (even though they use a hand-drawn sketch aesthetic and the `Virgil` font).
18
+
2.**NEVER Use Em-Dashes**: Never output the em-dash character in any prose, UI copy, markdown document, title, video script, social post, or code comment. Use commas, parentheses, colons, or separate sentences instead.
19
+
3.**Always Use Markdown Tables for Comparisons**: Whenever comparing tools, frameworks, architectures, pricing, or trade-offs, always render a structured Markdown or HTML comparison table.
20
+
4.**Dual-Theme Chalkboard & Royal Purple Visual System**:
-**Dark Mode (`.dark`, Stitch `b9e00f99c0d34e9884bf7766a014577b`)**: Obsidian Chalkboard (`#0B1326`) with purple/fuchsia radial glows, `#131B2E` / `#171F33` surfaces, `#060E20` deep wells, `#F1F5F9` chalk white text, `#7C3AED` tactile buttons with `#4C1D95` bottom lip, and `#C084FC` / `#D946EF` candy purple & fuchsia accents.
23
+
5.**Header & Mobile 3-Line Drawer Rule**:
24
+
- Do not put a `"Get Started"` CTA button inside the top header (`#site-header`). Keep the header clean with the AJ circular purple medallion + `CodingCat.dev` logo, desktop nav links (`lg:flex`), and on the right `Search`, `Ask Agent`, `ThemeToggle`, and on mobile/tablet (`lg:hidden`) the 3-line Hamburger Menu (`#nav-drawer-toggle`) opening `#nav-drawer`.
25
+
6.**Canonical 4-Font Typography**:
26
+
-`Nunito` (`800` / `900`): Chunky rounded `H1` and `H2` display titles and hero headlines.
27
+
-`Inter` (`400` to `800`): UI components, navigation, `H3`-`H6` subheadings, and long-form prose.
17
28
-`JetBrains Mono` (`400` to `700`): Code blocks, terminal snippets, badge tags, and metadata.
5.**AJ the Cat Mascot Guardrails**: Always reference canonical assets in `assets/` (`AJHeadphones.png`, `AJ-2D-Bipedal.jpg`, `AJ-3D-Headphones-Front.jpg`, `AJ-3D-Headphones-Left.jpg`, `AJ-3D-Headphones-Right.jpg`). Full-body AJ is always upright bipedal on two legs, with Electric Lime (`#C5E86C`) eyes, a Soft Lavender (`#B4A7D6`) collar with a pastel rainbow hexagonal `"AJ"`tag, and over-ear `"CodingCat.dev Podcast"` Royal Purple/Lavender headphones that properly cover his ears.
29
+
-`Virgil`: Hand-drawn annotations, sticky notes, and labels inside visual diagrams.
30
+
7.**AJ the Cat Mascot Guardrails**: Always reference canonical assets in `assets/` (`AJHeadphones.png`, `AJ-2D-Bipedal.jpg`, `AJ-3D-Headphones-Front.jpg`, `AJ-3D-Headphones-Left.jpg`, `AJ-3D-Headphones-Right.jpg`). Full-body AJ is always upright bipedal on two legs, wearing Royal Purple/Lavender podcast headphones and a hexagonal `"AJ"`collar tag.
20
31
21
32
---
22
33
@@ -26,18 +37,18 @@ Before writing UI code, drafting content, or generating visual assets, load the
26
37
27
38
| # | Category | Skill / Reference Path | When to Load |
28
39
| :--- | :--- | :--- | :--- |
29
-
|**01**|**Overview**|`skills/codingcat-design-system/references/01-overview.md`| Brand ethos, dark-mode-first philosophy, when to use AJ vs. Alex Patterson |
|**01**|**Overview**|`skills/codingcat-design-system/references/01-overview.md`| Brand ethos, canonical terminology (Courses, Podcasts, Blog, Diagrams), AJ vs. Alex Patterson |
41
+
|**02**|**Colors**|`skills/codingcat-design-system/references/02-colors.md`|Dual-theme tokens (Light `#FAF9FC`/`#2A1155`/`#7C3AED` & Dark `#0B1326`/`#131B2E`/`#7C3AED`/`#C084FC`) |
|**04**|**Spacing**|`skills/codingcat-design-system/references/04-spacing.md`|`4px` base grid, `1280px` max container, YouTube 16:9 and Shorts 9:16 safe zones |
33
-
|**05**|**Corner Radius**|`skills/codingcat-design-system/references/05-corner-radius.md`|Radius tokens from `rounded-none` (`0px`) to `rounded-2xl` (`16px`) and `rounded-full`|
|**05**|**Corner Radius**|`skills/codingcat-design-system/references/05-corner-radius.md`|`.hand-border`, `.hand-border-rect`, `rounded-xl` to `rounded-3xl`, and `rounded-full`|
CodingCat.dev blends Duolingo-inspired playful educational UI with authentic, hand-drawn Excalidraw architectural diagrams, sticky notes, and live code teardowns. Both Light Mode and Dark Mode are first-class citizens:
-**Courses** (`/courses` -> `/course/[slug]`): Structured learning made up of **Lessons** (`Explore Courses →`, `Start Course →`).
11
+
-**Podcasts** (`/podcasts` -> `/podcast/[slug]`): Video and audio conversations made up of **Episodes** (`Watch Podcasts`, `Watch Episode →`).
12
+
-**Blog** (`/blog` -> `/post/[slug]`): Written articles and code guides made up of **Blog Posts** (`Read Blog`, `Read Post →`).
13
+
2.**No Invented Synonyms**: Never call content `"Teardowns"`, `"Blueprints"`, `"Curriculum"`, `"Units"`, `"Boss Node"`, or `"Skill Trees"`.
14
+
3.**Diagrams Terminology**: Never write the brand word `"Excalidraw"` in user-facing UI labels, headings, filenames, or captions. Always refer to them simply as **Diagrams**, **Visual Diagrams**, or **Architecture Diagrams** in user-facing copy.
15
+
16
+
## 2. Visual Direction & Dual-Theme Philosophy
17
+
18
+
CodingCat.dev blends Duolingo-inspired playful educational UI with hand-drawn architectural diagrams, sticky notes, and real code. Both Light Mode and Dark Mode are first-class citizens:
10
19
-**Light Mode (`:root`)** uses a warm Chalkboard Paper background (`#FAF9FC`) with a subtle lavender dot grid (`#D8B4FE`), crisp white cards (`#FFFFFF`), deep Royal Purple ink (`#2A1155`), and hard-offset sketch shadows (`3px 4px 0 #2A1155`).
11
20
-**Dark Mode (`.dark`)** uses an Obsidian Chalkboard background (`#0B1326`) with ambient purple/fuchsia radial glows, slate-obsidian cards (`#131B2E` / `#171F33`), deep code/diagram wells (`#060E20`), chalk-white sketch borders (`rgba(255, 255, 255, 0.22)`), and dark offset sketch shadows (`3px 4px 0 rgba(0, 0, 0, 0.75)`).
12
21
13
-
## 2. Dual-Theme Color Tokens
22
+
## 3. Dual-Theme Color Tokens
14
23
15
24
| Token Role | Light Mode (`8d1319903d504a79ae56110486455e17`) | Dark Mode (`b9e00f99c0d34e9884bf7766a014577b`) | CSS Custom Property |
16
25
| :--- | :--- | :--- | :--- |
@@ -30,30 +39,7 @@ CodingCat.dev blends Duolingo-inspired playful educational UI with authentic, ha
1.**Display Headlines (`--font-display`)**: `Nunito` / `Fredoka` (`800-900` weight, tight tracking `-0.03em`). Used for playful lowercase hero and section titles (`free. fun. purrfect.`, `learn by building.`, `meet real codingcat learners & guests`).
36
-
2.**Excalidraw Hand-Drawn Explanations (`--font-hand`)**: `Virgil` / `Caveat` (`400-700` weight). Used for sketch subtitles (`learn by building real apps.`), sticky notes (`AJ's Tip`), flowchart node labels, and speech bubbles (`"Purrfect code!"`).
37
-
3.**UI & Editorial Body (`--font-sans`)**: `Plus Jakarta Sans` / `Inter` (`400-700` weight).
- Dark Mode: `background: #7C3AED` (hover `#8B5CF6`), white text, `#6EE7B7` arrow, `box-shadow: 0 4px 0 #4C1D95, 0 8px 20px rgba(124, 58, 237, 0.4)`
58
-
-**`.chalk-hatch`**:
59
-
- Diagonal `-45deg` repeating marker hatch fill in purple/lavender (`rgba(167, 139, 250, 0.35)` Light / `rgba(168, 85, 247, 0.35)` Dark).
42
+
## 4. Header & Mobile 3-Line Navigation Drawer
43
+
44
+
- The top header (`#site-header`) is a floating `rounded-full` pill bar containing the AJ circular purple medallion + `CodingCat.dev` logo on the left, desktop navigation links (`Courses`, `Podcasts`, `Blog`, `Sponsors`, `Sponsorships` on `lg:flex`), and on the right `Search`, `Ask Agent`, `ThemeToggle`, and on `<lg` the 3-line Hamburger Menu (`#nav-drawer-toggle`).
45
+
- Never place a `"Get Started"` CTA button inside `#site-header` so the mobile header never overflows.
0 commit comments