Skip to content

Commit 084c23b

Browse files
committed
feat: deploy
1 parent bac6770 commit 084c23b

40 files changed

Lines changed: 2117 additions & 1969 deletions

AGENTS.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,8 @@ Suggested order for phased work: `/analisar` (optional) → `/planejar` → `/ex
7474

7575
- **Astro** is the framework. It was chosen because this is content-first, not app-first. Ships minimal JS via island architecture.
7676
- **React** is used only for interactive islands (quizzes, comparators, steppers, filters), not for page-level rendering.
77-
- **CSS Modules + CSS Variables + design tokens**. No Tailwind. The Neo Brutalism visual language requires authorial control that utility-first CSS undermines.
78-
- **CSS-first animations**. Decorative and state-transition animations must be pure CSS. JavaScript animation is reserved for _interactive physics_ (drag, pointer tracking, procedural motion): use `motion` (drag only) or bespoke `requestAnimationFrame` loops. Do not introduce other animation libraries (GSAP, anime, react-spring, etc) without explicit approval.
77+
- **CSS Modules + CSS Variables + design tokens**. No Tailwind. The editorial visual language ("The Institute", see `REDESIGN.md`) requires authorial control that utility-first CSS undermines.
78+
- **CSS-first animations**. Decorative and state-transition animations must be pure CSS, and calm: fades and small settles only — no springs, shake, or sound. JavaScript animation is reserved for _interactive physics_ (drag, pointer tracking, procedural motion) via bespoke `requestAnimationFrame` loops. Do not introduce animation libraries (GSAP, anime, react-spring, motion, etc) without explicit approval.
7979
- **Content Collections** with schema validation for all session content (MDX with typed frontmatter).
8080

8181
### Key Architecture Decisions
@@ -111,13 +111,19 @@ The home page contains a compact foundations primer for "AI-Native Engineer", "A
111111

112112
Every session page follows a fixed template: hero → 30s summary → main explanation → why it matters → real example when useful → where it breaks → takeaway → references. Interactive blocks are used only when they clearly improve explanation, organization, or retention.
113113

114-
## Design System: Neo Brutalism
114+
## Design System: The Institute (Editorial)
115115

116-
- High contrast, block layout, thick black borders, hard offset shadows (no blur, no glassmorphism, no gradients)
117-
- Palette: warm light background, pure black, 2-3 vibrant accents (yellow, electric blue, acid green, or coral)
118-
- Heavy-weight headlines, neutral readable body text
119-
- Mobile-first: single column, reduced decoration, comfortable touch targets
120-
- WCAG contrast compliance and visible focus states
116+
The visual language is a quiet, typography-led editorial system inspired by institutional sites like mit.edu. Full art direction and rationale live in `REDESIGN.md`. It replaced the old Neo-Brutalist system.
117+
118+
- One accent only: signal red (`--color-accent`); everything else is paper, ink, and hairlines. Color never carries meaning alone (levels, statuses, and types are text labels).
119+
- Surfaces: warm paper background, white raised surfaces, charcoal dark theme (never blue-graphite).
120+
- Structure: 1px hairlines (`var(--line)`) and whitespace separate sections. No thick borders, no hard offset shadows — all `--shadow-*` tokens are `none`; `var(--shadow-overlay)` exists only for floating UI.
121+
- Typography: Inter Tight for display/headings (`--font-display`, tracking -0.02em), Inter for body, Newsreader italic for ledes and pull quotes (`--font-serif`), JetBrains Mono for code.
122+
- Brand mark: typographic wordmark preceded by a small red square; favicon is the red square on paper.
123+
- Motion: calm only — fades and small settles with `var(--ease-standard)`. No springs, no screen shake, no audio.
124+
- Patterns: `.kicker` micro-labels mark sections; badges are neutral hairline chips (`variant="accent"` reserved for true highlights); cards are flat with hairline borders and underline-on-hover titles; the inverted ink band is reserved for the manifesto moment.
125+
- Mobile-first: single column, reduced decoration, comfortable touch targets.
126+
- WCAG contrast compliance and visible focus states.
121127
- Breakpoints: mobile ≤767px, tablet 768-1023px, desktop 1024px+, wide 1440px+
122128

123129
## Editorial Rules

REDESIGN.md

Lines changed: 235 additions & 0 deletions
Large diffs are not rendered by default.

ROADMAP.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -216,3 +216,27 @@ Things we might do later, but absolutely not now:
216216
- auth / user accounts
217217
- CMS integration
218218
- gamification
219+
220+
---
221+
222+
## Redesign Track: The Institute (Editorial)
223+
224+
Full visual redesign replacing Neo Brutalism with the editorial system defined in `REDESIGN.md`. Implemented as sequential commits on `main` (no PRs), validated and pushed once at the end.
225+
226+
- [x] Phase 1 — Foundations: tokens (both themes), typography, fonts, favicon
227+
- [x] Phase 2 — Primitives: Button, Badge, Card (+ `index` prop), kitchen-sink as permanent design-system page
228+
- [x] Phase 3 — Chrome: SiteHeader (red-square wordmark), ThemeToggle, Footer, SectionNav
229+
- [x] Phase 4+5 — Home de-gimmick (toy layer unwired; dirs pending `git rm`) + editorial home (pt/en): masthead hero, feature story, curriculum grid, manifesto band, more-from rows
230+
- [x] Phase 6 — Article template: SessionLayout, BlogPostLayout, NextSessionCTA, ReferencesList (numbered endnotes), ProgressTracker (2px bar), Discussion
231+
- [x] Phase 7 — Secondary templates I: blog index (pt/en), colinha (pt/en)
232+
- [x] Phase 8 — Secondary templates II: projeto pages, harness pages, 404 (pt/en), ChapterLayout, HarnessChapterLayout, `harness-chapter.css`
233+
- [x] Phase 9 — Deps & docs: `motion` dependency removed, AGENTS.md design section replaced, this track
234+
- [ ] Phase 10 — Final validation gate (`lint` + `format:check` + `build`, full click-through, both themes/locales) + single push
235+
236+
### Follow-ups after the redesign ships
237+
238+
- [ ] `git rm -r src/components/HeroStickers src/components/HeroGhostCursors src/components/HeroCursorTrail src/components/HeroCaptureCounter` (already unwired from all pages/layouts)
239+
- [ ] Sweep legacy token aliases, then delete the alias block in `tokens.css` and the `brutal-*` keyframes in `globals.css`:
240+
`grep -rn "accent-[1-4]\|fg-on-yellow\|fg-on-blue\|fg-on-green\|fg-on-coral\|border-thick\|color-shadow\|font-heading\|ease-snap\|ease-out-back\|brutal-\|color-white\|color-primary\|color-border\b" src/`
241+
- [ ] Migrate island CSS internals (ChapterNav, ChapterFooter, harness/*) to semantic tokens — they currently inherit the new look through the legacy aliases
242+
- [ ] PLAN.md design-language sweep (historical discovery doc; design source of truth is now `REDESIGN.md` + `AGENTS.md`)

0 commit comments

Comments
 (0)