Skip to content

task_plan.md

Latest commit

 

History

History
84 lines (64 loc) · 4.44 KB

task_plan.md

File metadata and controls

84 lines (64 loc) · 4.44 KB
Raw

Task Plan — Ink and Code

Objective: Build a modular creator platform for technical storytelling with a dynamic cosmic tree archive (The Grove), utilizing a local Git-backed MDX content engine and a semi-automated social publishing pipeline powered by n8n.

Scope Boundaries

In-Scope

  • Next.js app skeleton (App Router + TypeScript + Tailwind).
  • State-driven, interactive SVG Grove (desktop tree view, mobile timeline view).
  • Metadata frontmatter parsing for posts, blogs, and articles.
  • Next.js local content loader parsing MDX files dynamically.
  • n8n webhook triggers on Git push to automate cross-publishing.
  • Clean responsive layout with Outfit typography and glassmorphism styling.

Out-of-Scope (V1)

  • External databases (Supabase, Postgres, Firebase).
  • User authentication / login dashboards (Git-driven edits only).
  • Comment sections / community forums.
  • Audio narration / voice podcasts / video uploads.
  • Procedural placement algorithms for the SVG Grove (pre-defined coordinate mapping).

Milestones & Acceptance Criteria

Milestone 0: Foundation [COMPLETED]

  • Acceptance Criteria: Next.js skelton created, folder structure mapped, core skills synchronized, and blueprint files written.

Milestone 1: Content Engine & MDX Loader [COMPLETED]

  • Acceptance Criteria: Custom MDX parser loaded in /lib, type-safe frontmatter schema defined, and sample post rendering in a simple Next.js page.

Milestone 2: Home Page & Core Layout [COMPLETED]

  • Acceptance Criteria: Global Layout (Navbar, footer) implemented, Hero section with particles, Featured post block, and Recent posts grid fully responsive.

Milestone 3: Post Templates [COMPLETED]

  • Acceptance Criteria: Unique layout templates built for (1) Short Posts, (2) Blog Articles, and (3) In-depth Technical Essays.

Milestone 4: The Grove (Masterpiece Archive) [COMPLETED]

  • Acceptance Criteria: Desktop interactive SVG tree overlay positioned over background image with animated nodes, blinking flowers, and directional energy flow. Mobile view uses a vertical SVG timeline.

Milestone 5: Category Filtering [COMPLETED]

  • Acceptance Criteria: Standard fallback archive grid with categories tabs and card sorting.

Milestone 6: "Now" Teaser Section [COMPLETED]

  • Acceptance Criteria: A dynamic teaser section showing active projects, books, or current events pulled from local JSON or git content.

Milestone 7: Automation & Pipeline [COMPLETED]

  • Acceptance Criteria: Secure POST revalidation API webhook endpoint established to trigger re-compiles on new commits.

Milestone 8: Polish & Launch [COMPLETED]

  • Acceptance Criteria: Framer Motion entrance aesthetics, SVG energy flows, compass-star shape structures, and zero-warning linter sweeps.

Current Status & Task List

  • Current Milestone: Milestone 8 — Polish & Launch
  • Active Focus: Production scaffolding, routing structures, and interactive animations completed.

Checklist

  • Create project blueprint files (project_constitution.md, task_plan.md, findings.md).
  • Initialize Next.js app in the project root.
  • Setup folder structure (/app, /components, /content, /lib, /public).
  • Define linting configs using ESLint v9 flat config.
  • Install next-mdx-remote and gray-matter dependencies.
  • Create content type definitions in lib/types.ts.
  • Implement filesystem loader utilities in lib/content.ts.
  • Write sample test post in content/posts/first-transmission.mdx.
  • Create dynamic post rendering page route in app/posts/[slug]/page.tsx.
  • Configure Google Fonts loading in root layout.
  • Create core global layout shell components (Navbar and Footer).
  • Inject Navbar and Footer into layout wrapper.
  • Install shiki and rehype-pretty-code dependencies.
  • Create styled Callout markdown component.
  • Build layout templates for Post, Blog, and Article.
  • Implement dynamic layout router and syntax highlighting on the single post route.
  • Create client-side search, filtering, and sorting for Archive index.
  • Integrate /archive route with Suspense.
  • Construct profile, focus card, and layout styles for the /now route.
  • Establish secure POST revalidation API webhook endpoint.
  • Implement animated SVG energy flows and rotating compass-star flower shapes in the Grove canvas.
  • Conduct clean compile and zero-warning linter sweep.