Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 67 additions & 19 deletions ROADMAP.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,75 @@
# 📅 Q4 2025 Faust Refactor Roadmap
# 📅 Q4 2025 Headless WordPress Toolkit & Faust Refactor Roadmap

| Sprint | Dates | Focus Areas | Key Deliverables |
|--------|----------------|-----------------------------|-----------------|
| 1 | Oct 7 – Oct 20 | 🛤 Roadmap + Toolbar (first cut) | - Publish roadmap (internal + OSS)<br>- Scaffold `@wpengine/hwp-toolbar` package<br>- Toolbar alpha (Preview + Edit buttons, responsive & accessible)<br>- Demo app with Toolbar |
| 2 | Oct 21 – Nov 3 | 📐 Core Packages (iteration 1) | - Scaffold `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-graphql-client`<br>- GraphQL client wrapper MVP<br>- Template Hierarchy MVP (basic post/page rendering) |
| 3 | Nov 4 – Nov 17 | 📦 Core Packages (iteration 2) | - Publish Template Hierarchy alpha<br>- Publish GraphQL Client alpha<br>- Toolbar beta (theming tokens, accessibility improvements)<br>- Scaffold `@wpengine/hwp-auth`<br>- Draft: *Getting Started with Faust v2* doc |
| 4 | Nov 18 – Dec 1 | 🔗 Framework Adapter + Utils | - Next.js App Router adapter beta (or Pages router)<br>- Publish `@wpengine/hwp-utils` package<br>- Toolbar adds draft/publish toggle<br>- Migration Guide v1 |
| 5 | Dec 2 – Dec 15 | 🚀 DX + Starter Tooling | - Finalize Toolbar stable (white-label theming)<br>- Starter CLI: `npx create-faust-app` (Next.js baseline) (or just a template)<br>- Docs: Migration guide expanded with examples |
| 6 | Dec 16 – Dec 23 | 🎉 Release Prep & OSS Launch | - Internal & OSS testing of migration flow<br>- Publish Next.js adapter stable<br>- Release Faust Core v4.0 (Next.js baseline)<br>- Community demo + OSS announcement<br>- Plan Q1 2026 (Astro + SvelteKit adapters) |
This roadmap reflects updated priorities for Q4 2025, emphasizing QA and GA release of the `wpgraphql-logging` plugin, exposure of existing documentation to the Docs site, and focused development on key Headless WordPress Toolkit packages.

---

## 🧭 Strategic Priorities

1. **QA and GA release of `wpgraphql-logging` plugin**
- Validate and release the plugin before end of November.
- Ensure it meets pre-GA QA standards and integrates cleanly with the Toolkit.

2. **Developer documentation for the Headless WordPress Toolkit**
- Expose existing `.md` files for the Logging Plugin to the Docs site.
- Improve overall Docs structure to support Toolkit content.

3. **Focused Toolkit package development**
- Prioritize `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`.
- Defer additional package work to Q1 2026.

---

## 🗓 Sprint Breakdown

| Sprint | Dates | Focus Areas | Key Deliverables |
|--------|----------------|---------------------------------------|-----------------|
| **1** | Oct 7 – Oct 20 | 🛤 Planning + Initial Scaffolds | - Publish updated roadmap (internal + OSS)<br>- Scaffold `@wpengine/hwp-toolbar` (carryover)<br>- Demo app updated for internal testing<br>- Prepare QA environment for `wpgraphql-logging` plugin |
| **2** | Oct 21 – Nov 3 | ✅ **QA & Validation** | - **Pre-GA testing and validation of `wpgraphql-logging` plugin**<br>- Track QA results and fix issues for GA<br>- Integrate initial developer docs for Headless WP Toolkit<br>- *(Stretch goal)* Validate Toolkit examples function as expected |
| **3** | Nov 4 – Nov 17 | 📘 **Docs Integration & Exposure** | - **Expose existing `wpgraphql-logging` plugin `.md` docs to the public Docs site**<br>- Continue improving developer docs for the Headless WP Toolkit<br>- Ensure Docs site structure supports Toolkit and Logging content<br>- Plan GA release logistics for `wpgraphql-logging` |
| **4** | Nov 18 – Dec 1 | 🚀 **Final QA + GA Release** | - **Final QA pass and GA release of `wpgraphql-logging` plugin** 🎉<br>- Begin focused development on `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth` packages<br>- Internal validation and documentation for these packages |
| **5** | Dec 2 – Dec 15 | 🧩 **Toolkit Package Development** | - Continue iteration on `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`<br>- Internal beta testing of both packages<br>- Refine Toolkit + Faust integration notes<br>- Update roadmap and documentation accordingly |
| **6** | Dec 16 – Dec 23 | 🎉 **Release Prep & OSS Launch** | - OSS publication of Toolkit-related packages and docs<br>- Publish Next.js adapter alignment roadmap<br>- Internal & OSS communication (GA recap + next steps)<br>- Plan Q1 2026: Astro + SvelteKit adapter expansion |

---

## 🎯 End of Quarter Outcomes
- Core packages available: Template Hierarchy, GraphQL Client, Toolbar
- Framework adapter: Next.js App/Pages Router stable
- CLI tooling + Docs
- DX improvements: starter project generator (`npx create-faust-app`)
- Docs: Getting Started, migration guide, roadmap published

- ✅ **`wpgraphql-logging` plugin GA release completed**
- 📘 **Toolkit developer docs published and integrated into Docs site**
- 🧩 **`@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth` packages in beta**
- 🌐 **Improved developer experience with validated Toolkit integration flow**
- 🗺 **Q1 2026 roadmap prepared for adapter expansion (Astro, SvelteKit)**

---

## 👉 By Dec 23, 2025, Developers Can

- Use the **GA version of the `wpgraphql-logging` plugin**
- Access **Toolkit documentation directly on the Docs site**
- Integrate **`@wpengine/hwp-template-hierarchy`** and **`@wpengine/hwp-auth`** in projects
- Test and contribute to the growing **Faust + Toolkit ecosystem**

---

## 🧾 GA Readiness Checklist (Logging Plugin)

| Area | Criteria | Owner | Status |
|------|-----------|--------|--------|
| QA Testing | All test cases pass across supported WP + GraphQL versions | QA | 🔄 In progress |
| Docs | `.md` files exposed and verified on Docs site | Docs | ✅ Ready |
| Compatibility | Verified with latest WPGraphQL + Toolkit packages | Eng | 🔄 In progress |
| Release | Tagged on GitHub + WP Updater | Eng | ⏳ Planned (Sprint 4) |
| Announcement | GA summary and migration notes published | Comms | ⏳ Planned (Sprint 6) |

---

## 🔮 Looking Ahead (Q1 2026 Preview)

- Expand Headless WordPress Toolkit with **Astro** and **SvelteKit** adapters.
- Continue improving `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`.
- Broaden Toolkit integration with Faust Core and community examples.

---

## 👉 By Dec 23, 2025, developers can:
- Scaffold a Faust app in minutes
- Use the modular Template Hierarchy + GraphQL Client without boilerplate
- Provide editors a functional Toolbar
- Migrate legacy Faust projects safely
_Last updated: Oct 21, 2025_