|
1 | | -# 📅 Q4 2025 Faust Refactor Roadmap |
| 1 | +# 📅 Q4 2025 Headless WordPress Toolkit & Faust Refactor Roadmap |
2 | 2 |
|
3 | | -| Sprint | Dates | Focus Areas | Key Deliverables | |
4 | | -|--------|----------------|-----------------------------|-----------------| |
5 | | -| 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 | |
6 | | -| 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) | |
7 | | -| 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 | |
8 | | -| 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 | |
9 | | -| 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 | |
10 | | -| 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) | |
| 3 | +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. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## 🧭 Strategic Priorities |
| 8 | + |
| 9 | +1. **QA and GA release of `wpgraphql-logging` plugin** |
| 10 | + - Validate and release the plugin before end of November. |
| 11 | + - Ensure it meets pre-GA QA standards and integrates cleanly with the Toolkit. |
| 12 | + |
| 13 | +2. **Developer documentation for the Headless WordPress Toolkit** |
| 14 | + - Expose existing `.md` files for the Logging Plugin to the Docs site. |
| 15 | + - Improve overall Docs structure to support Toolkit content. |
| 16 | + |
| 17 | +3. **Focused Toolkit package development** |
| 18 | + - Prioritize `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`. |
| 19 | + - Defer additional package work to Q1 2026. |
| 20 | + |
| 21 | +--- |
| 22 | + |
| 23 | +## 🗓 Sprint Breakdown |
| 24 | + |
| 25 | +| Sprint | Dates | Focus Areas | Key Deliverables | |
| 26 | +|--------|----------------|---------------------------------------|-----------------| |
| 27 | +| **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 | |
| 28 | +| **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 | |
| 29 | +| **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` | |
| 30 | +| **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 | |
| 31 | +| **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 | |
| 32 | +| **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 | |
11 | 33 |
|
12 | 34 | --- |
13 | 35 |
|
14 | 36 | ## 🎯 End of Quarter Outcomes |
15 | | -- Core packages available: Template Hierarchy, GraphQL Client, Toolbar |
16 | | -- Framework adapter: Next.js App/Pages Router stable |
17 | | -- CLI tooling + Docs |
18 | | -- DX improvements: starter project generator (`npx create-faust-app`) |
19 | | -- Docs: Getting Started, migration guide, roadmap published |
| 37 | + |
| 38 | +- ✅ **`wpgraphql-logging` plugin GA release completed** |
| 39 | +- 📘 **Toolkit developer docs published and integrated into Docs site** |
| 40 | +- 🧩 **`@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth` packages in beta** |
| 41 | +- 🌐 **Improved developer experience with validated Toolkit integration flow** |
| 42 | +- 🗺 **Q1 2026 roadmap prepared for adapter expansion (Astro, SvelteKit)** |
| 43 | + |
| 44 | +--- |
| 45 | + |
| 46 | +## 👉 By Dec 23, 2025, Developers Can |
| 47 | + |
| 48 | +- Use the **GA version of the `wpgraphql-logging` plugin** |
| 49 | +- Access **Toolkit documentation directly on the Docs site** |
| 50 | +- Integrate **`@wpengine/hwp-template-hierarchy`** and **`@wpengine/hwp-auth`** in projects |
| 51 | +- Test and contribute to the growing **Faust + Toolkit ecosystem** |
| 52 | + |
| 53 | +--- |
| 54 | + |
| 55 | +## 🧾 GA Readiness Checklist (Logging Plugin) |
| 56 | + |
| 57 | +| Area | Criteria | Owner | Status | |
| 58 | +|------|-----------|--------|--------| |
| 59 | +| QA Testing | All test cases pass across supported WP + GraphQL versions | QA | 🔄 In progress | |
| 60 | +| Docs | `.md` files exposed and verified on Docs site | Docs | ✅ Ready | |
| 61 | +| Compatibility | Verified with latest WPGraphQL + Toolkit packages | Eng | 🔄 In progress | |
| 62 | +| Release | Tagged on GitHub + WP Updater | Eng | ⏳ Planned (Sprint 4) | |
| 63 | +| Announcement | GA summary and migration notes published | Comms | ⏳ Planned (Sprint 6) | |
| 64 | + |
| 65 | +--- |
| 66 | + |
| 67 | +## 🔮 Looking Ahead (Q1 2026 Preview) |
| 68 | + |
| 69 | +- Expand Headless WordPress Toolkit with **Astro** and **SvelteKit** adapters. |
| 70 | +- Continue improving `@wpengine/hwp-template-hierarchy` and `@wpengine/hwp-auth`. |
| 71 | +- Broaden Toolkit integration with Faust Core and community examples. |
20 | 72 |
|
21 | 73 | --- |
22 | 74 |
|
23 | | -## 👉 By Dec 23, 2025, developers can: |
24 | | -- Scaffold a Faust app in minutes |
25 | | -- Use the modular Template Hierarchy + GraphQL Client without boilerplate |
26 | | -- Provide editors a functional Toolbar |
27 | | -- Migrate legacy Faust projects safely |
| 75 | +_Last updated: Oct 21, 2025_ |
0 commit comments