Wagtail Starter Kit Upgrade Stabilization Modernization Developer Experience
The current Wagtail news starter template presents significant onboarding challenges for new developers, including dependency conflicts, Python version incompatibilities, lack of cross-platform setup support, and incomplete features such as a non-functional newsletter and missing RSS feed. This project aims to transform the starter template into a reliable, modern, and beginner-friendly entry point into the Wagtail ecosystem. The approach is structured across three pillars: 1. Stabilization: Introduce CI targeting the latest stable versions, resolve dependency conflicts, enforce reproducible installations, and implement a cross-platform setup system using a single Python entry point validated via CI on both Linux and Windows. 2. Modernization: Replace broken or missing features with Wagtail-native implementations, including a working newsletter (FormPage), RSS feed, improved admin interfaces (PageListingViewSet, SnippetViewSet), SEO fixes, modular StreamField block architecture, and GDPR-compliant asset handling. 3. Developer Experience: Improve onboarding through interactive admin guidance, simplified frontend tooling, better inline documentation, and demo content that works out-of-the-box. Deliverables include a fully functional, CI-validated starter template, modular and reusable architecture, improved documentation, and a setup experience that reduces time from clone to running project to under five minutes. Initial validation experiments show a 100% setup success rate in controlled environments with zero dependency conflicts, demonstrating feasibility.
Project details
Technologies
Not listed in the archive