Roadmap
A release-driven view of PyColors work across UI foundations, guides, patterns, Starter Free, Starter Pro, commercial delivery, trust, and product clarity.
This roadmap reflects current product direction. It is not a contractual delivery promise, and scope may evolve based on real usage, feedback, bugs, and commercial priorities.
- shipped78
- now3
- next4
- later0
Single thing
Ship the PyColors funnel: Guides → Blog → Patterns / Examples → Starter Free → Starter Pro.
Documentation-first
Every component, guide, article, and starter should help users understand what to build, why it matters, and how to ship.
Commercial readiness
Trust pages, pricing clarity, launch proof, delivery reliability, analytics, docs depth, auth, and billing.
Release-driven, not promise-driven.
Shipped items reflect public work already released. Now reflects active cleanup and product priorities. Next and Later are used only when public scope is realistic enough to show.
Release Week
Ship PyColors UI v1.0: core components, docs baseline, and release hygiene.
Ship v1.0 — UI Core
Button, Input, Badge, Card, Alert: consistent variants, sizing, docs, preview, usage, code, and props.
Shipped- Core
- Docs
Docs quality pass
Unify related guides, add missing Preview/Code tabs, fix footer consistency, and clean navigation.
Shipped- Docs
- DX
Release hygiene
Changelog page, Roadmap page, version bump, and release notes format.
Shipped- Release
- Trust
January 2026
Stabilize quality, improve docs, and strengthen the distribution loop.
Marketing site baseline
Home page v2 and dedicated pages for templates, license, about, trust, and ecosystem positioning.
Shipped- Marketing
- Trust
Patterns docs v1
Production UX rules and interactive demos for overlays, async actions, and data table states.
Shipped- Docs
- Patterns
- DX
Distribution loop v1
Repeatable launch routine: demo links, screenshot kit, what’s new posts, and publish checklist.
Shipped- Growth
- Launch
February 2026
Ship Starter Free publicly and strengthen the trust baseline.
UI Advanced v1
Dialog, Dropdown, Tabs, Tooltip, and Toast with accessibility-first behavior.
Shipped- Advanced
- Components
- Accessibility
Public packages
Published @pycolors/tokens and @pycolors/eslint-config on npm to strengthen ecosystem consistency.
Shipped- Ecosystem
- NPM
- DX
Starter Free public alpha
Starter Free publicly documented and positioned as the onboarding entry point.
Shipped- Starters
- Docs
- Launch
Starter docs v1
Installation, structure, conventions, deployment, upgrade path, auth, and billing concepts.
Shipped- Docs
- Starters
- DX
March 2026
Move from PRO positioning into implementation: Starter Pro foundation, billing maturity, auth baseline, and conversion surfaces.
Guides knowledge layer
Dedicated Guides layer covering product foundations, auth, billing, dashboards, admin, and team systems.
Shipped- Guides
- SaaS
- Education
Patterns + Examples discovery layer
Dedicated marketing pages for SaaS patterns and examples to show what users can learn, validate, and build.
Shipped- Patterns
- Examples
- Marketing
PRO upgrade funnel
Dedicated upgrade page clarifying the value of moving from validation surfaces to production-ready wiring.
Shipped- PRO
- Upgrade
- Sales
Billing system v1
Stripe checkout, billing portal, webhook processing, subscription lifecycle, invoice sync, and PRO access enforcement.
Shipped- Billing
- Stripe
- Monetization
Starter PRO auth foundation
Auth.js, Prisma-backed auth models, credentials, OAuth-ready providers, JWT sessions, verification, reset password, and transactional emails.
Shipped- Auth
- Starter PRO
- Security
April 2026
Turn Starter Pro into a real commercial product with purchase flow, secure delivery, and pricing clarity.
OAuth sign-in and sign-up UX
First-class Google and GitHub OAuth entry points with better loading states and onboarding UX.
Shipped- Auth
- OAuth
- Starter PRO
Auth security hardening
Rate limiting, generic responses, and audit metadata collection for sensitive auth actions.
Shipped- Auth
- Security
- Rate limiting
Starter Pro public commercial launch
Starter Pro became publicly available and purchasable on pycolors.io.
Shipped- Starter PRO
- Launch
- Sales
Secure claim, download, and access recovery
Post-purchase access surfaces for claim, download, and recovery to make Starter Pro delivery more credible.
Shipped- Delivery
- Download
- Trust
Pricing route consolidation
Renamed /access to /pricing and updated links, breadcrumbs, sitemap priorities, and commercial references.
Shipped- Pricing
- Navigation
- Conversion
Reusable marketing hero system
Unified marketing hero sections through a reusable PageHero component.
Shipped- Marketing
- Components
- Consistency
May 2026
Turn documentation, branding, tokens, starters, pricing, and upgrade paths into a more premium and conversion-ready product surface.
Premium docs navigation and header system
Refined docs header, mobile navigation, search access, theme toggle placement, sidebar hierarchy, and fixed header behavior.
Shipped- Docs
- Navigation
- Mobile
Focused docs reading experience
Improved TOC behavior, heading hierarchy, active states, sidebar clarity, responsive spacing, and table styling.
Shipped- Docs
- TOC
- Accessibility
Starter Free documentation refinement
Clearer onboarding, product-surface evaluation, mocked-vs-wired explanations, and stronger upgrade path.
Shipped- Starter Free
- Docs
- Upgrade
Starter Pro production documentation expansion
Production readiness, auth, billing, backend, delivery, upgrade timing, and buyer confidence.
Shipped- Starter PRO
- Docs
- Trust
Marketing and pricing polish
Refined hero styling, pricing hierarchy, card consistency, badge styling, buttons, accessibility, and layout details.
Shipped- Marketing
- Pricing
- Conversion
Premium brand, token, and conversion polish
Refined the PyColors brand system, token architecture, homepage, pricing, upgrade path, starter pages, screenshots, headers, footers, changelog, and roadmap for a more cohesive premium SaaS platform experience.
Shipped- Brand
- Tokens
- Conversion
NA-AI Landing commercial template
Integrated NA-AI Landing as a premium AI SaaS landing page product with docs, license, demo, pricing, and purchase flow.
Shipped- Templates
- NA-AI
- Monetization
Multi-product commerce foundation
Generalized checkout, customer access, recovery, delivery, and product messaging for multiple premium digital products.
Shipped- Commerce
- Delivery
- Monetization
Templates documentation system
Added template docs, NA-AI Landing guides, licensing guidance, customization docs, and clearer product selection paths.
Shipped- Docs
- Templates
- Onboarding
Blog editorial UX polish
Refined blog layout, prose, metadata, sharing, accessibility, and reading flow to support authority-building content.
Shipped- Blog
- SEO
- Authority
Reusable docs component system
Unified documentation pages around reusable feature grids, CTA blocks, concept tabs, decision grids, related links, steps, and clearer heading hierarchy.
Shipped- Docs
- Components
- DX
NA-AI Landing documentation expansion
Expanded setup, customization, deployment, project structure, license guidance, and production-readiness documentation for the NA-AI Landing template.
Shipped- Templates
- NA-AI
- Docs
Documentation decision surfaces
Added clearer concept tabs and decision grids to help users compare product paths and understand when to use templates, UI, Starter Free, or Starter Pro.
Shipped- Docs
- Conversion
- Product
Starter Pro production architecture documentation
Expand Starter Pro documentation around architecture, deployment, infrastructure, environment variables, and production scalability patterns.
Shipped- Starter PRO
- Docs
- Architecture
Scalable token foundation
Migrate radius tokens to scalable rem-driven architecture for stronger consistency, theming flexibility, and long-term design-system maintainability.
Shipped- Tokens
- Design System
- Scalability
Trusted Publishing infrastructure
Harden npm publishing workflows through GitHub OIDC Trusted Publishing, Changesets automation, and improved release reliability.
Shipped- CI
- Release
- Infrastructure
Commercial upgrade clarity
Strengthen Free-to-Pro positioning with clearer upgrade messaging, product differentiation, and production-ready SaaS value communication.
Shipped- Conversion
- Upgrade
- Starter PRO
Starter Pro sales proof and trust content
Add implementation comparisons, real architecture explanations, buyer reassurance, launch checklists, and authority content.
Now- Trust
- Content
- Starter PRO
June 2026
Ship Starter Pro PWA foundations, buyer trust and purchase-flow clarity, local validation depth, release history, analytics, and stronger public product recovery paths.
Starter Pro PWA foundation
Added installable manifest metadata, service worker registration, offline fallback behavior, PWA icons and screenshots, mobile viewport tuning, and app-like product messaging.
Shipped- Starter PRO
- PWA
- Mobile
Public shell and safe-area layout system
Introduced shared public header and shell layouts for marketing and auth pages, centralizing navigation, footer structure, sticky headers, safe-area spacing, and responsive viewport behavior.
Shipped- Starter PRO
- Layout
- UX
Local validation and billing testing docs
Expanded Starter Pro guidance for local development, seeded auth fixtures, production-shaped test accounts, Stripe Checkout validation, webhook sync, and billing-aware access checks.
Shipped- Docs
- Testing
- Billing
Analytics, SEO, and recovery-path hardening
Added Vercel Analytics to marketing and Starter Free, tightened Starter Free demo indexing controls, and improved 404 recovery paths with grouped ecosystem links and clearer CTAs.
Shipped- Analytics
- SEO
- Navigation
Starter Pro release history and packaging
Added Starter Pro release history documentation, centralized versioning policy references, and a release script for packaging versioned Starter Pro archives.
Shipped- Release
- Docs
- Starter PRO
Marketing proof and launch visibility
Added Starter Free and Starter Pro promotional screenshots, a rotating hero carousel, Product Hunt badges, PWA-focused guides, and stronger public messaging around pragmatic SaaS PWA foundations.
Shipped- Marketing
- Proof
- PWA
Starter Pro conversion instrumentation
Measure the docs-to-pricing-to-checkout funnel across Starter Free, Starter Pro, pricing, upgrade, and post-purchase access, starting with Vercel Analytics coverage.
Shipped- Analytics
- Conversion
- Sales
Starter Pro buyer trust and purchase-flow clarity
Improved checkout success, purchase recovery, claim and download, Getting Started, pricing navigation, and consistent post-purchase terminology for Starter Pro buyers.
Shipped- Starter PRO
- Trust
- Conversion
Starter Pro hosted demo
Publish a hosted Starter Pro demo so buyers can evaluate the production-shaped product surface before purchase.
Next- Starter PRO
- Demo
- Trust
Starter Pro video walkthrough
Publish a concise walkthrough from purchase to first local run so buyers understand delivery, setup, and next steps faster.
Next- Starter PRO
- Trust
- Onboarding
Traffic-readiness trust cleanup
Remove stale links, unfinished public promises, and outdated claims before sending more traffic to roadmap, changelog, pricing, and product pages.
Shipped- Trust
- SEO
- Marketing
July 2026
Improve Starter Pro conversion proof, stabilize the free UI and token layer, recover the missed release week, and strengthen release reliability for faster premium product delivery.
Starter Pro demo visibility and conversion proof
Improved live demo visibility, Starter Free → Demo → Starter Pro flow, annotated screenshots, what-you-receive messaging, buyer confidence near purchase CTAs, comparison clarity, and documentation entry points without backend or pricing changes.
Shipped- Starter PRO
- Conversion
- Trust
@pycolors/ui v1.1.2 accessibility hardening
PasswordInput now fully respects the disabled state on its visibility toggle, and TableLoading exposes accessible live-region semantics, backed by new Vitest, jsdom, and Testing Library regression coverage for exports, forms, password visibility, tables, Card semantics, and EmptyState semantics. No public API, export, prop, variant, or size changed. Data-slot consistency, Pagination asChild support, and a Checkbox error API remain open follow-up work.
Shipped- @pycolors/ui
- Accessibility
- Testing
@pycolors/ui production-readiness sprint
Landed nonbreaking accessibility, contrast, validation, reduced-motion, table semantics, and React Server Component reliability improvements with broader automated coverage. The work is now reflected in the repository package baseline for @pycolors/ui v1.1.4 and @pycolors/tokens v1.2.2.
Shipped- @pycolors/ui
- Quality
- Accessibility
Release catch-up and UI delivery cleanup
Closed the missed 24 July marketing release with a focused operational note covering Card RSC follow-up, generated docs source maintenance, dependency alignment, and release-preflight cleanup without changing pricing, checkout, backend behavior, or product scope.
Shipped- Release
- Marketing
- Reliability
@pycolors/tokens v1.2.2 contrast baseline
Added dedicated success and warning foreground tokens for light and dark themes, plus Tailwind v4 theme bridges, giving Badge and future components a clearer accessible status-color foundation without requiring consumer migrations.
Shipped- @pycolors/tokens
- Accessibility
- Design System
Component standards and reliable delivery foundation
Established durable component API conventions, production-safe documentation examples, repeatable release controls, and a governed engineering workflow so the ecosystem can ship focused improvements with lower regression risk.
Shipped- DX
- Documentation
- Release
August 2026
PyColors Marketing v1.21.0 shipped on 7 August 2026 with clearer public guidance for adoption, customization, upgrades, and product evaluation.
PyColors Marketing v1.21.1
Added the 2026-08-14 public marketing update to make the paths across UI, documentation, starters, and templates easier to evaluate while preserving the full roadmap context.
Shipped- Marketing
- Trust
- SEO
PyColors UI adoption guidance
Shipped connected installation, usage, migration, theming, and accessibility guidance with more reliable documentation navigation.
Shipped- Docs
- DX
- Accessibility
Starter Pro purchase clarity
Shipped clearer purchase expectations so teams can evaluate Starter Pro with more confidence before continuing.
Shipped- Starter Pro
- Trust
September 2026
The 25 September 2026 PyColors Marketing v1.25.0 update strengthens product proof, purchase and recovery guidance, live UI evaluation, and the showcase-first homepage journey.
PyColors Marketing v1.25.0
Shipped on 25 September 2026 with clearer Starter Pro purchase and recovery guidance, stronger product proof, verified live UI evaluation links, and a showcase-first homepage journey.
Shipped- Marketing
- Trust
- DX
Starter Pro purchase and recovery clarity
Distinguish verified success from incomplete checkout states, expose recovery and support paths, and connect buyers to delivery and first-session guidance.
Shipped- Starter Pro
- Trust
- Commerce
Live PyColors UI evaluation
Connect UI documentation to the verified live UI Explorer and consumer Storybook guidance so component behavior and examples are easier to inspect.
Shipped- UI
- Docs
- DX
Showcase-first product journey
Bring interactive product proof earlier on the homepage and pair Starter Pro offers with annotated screenshots so evaluation starts from visible product behavior.
Shipped- Marketing
- Product
- Trust
Product-specific setup guidance
Choose a product path, follow its setup guide, and verify the first result. UI installation explains token CSS and styling setup before the first component.
Shipped- Docs
- DX
Interactive UI usage examples
Try notification settings, a rename dialog, a paginated members table, and save feedback with complete source. Examples use local state; applications own persistence and product behavior.
Shipped- UI
- Docs
- DX
Design-system principles
Use documented rules for semantic roles, composition, ownership, and accessibility when adapting UI primitives to a product.
Shipped- Design System
- Docs
- Accessibility
Semantic color and Toast readability
PyColors UI v1.5.4 and PyColors Tokens v1.2.3 improve light muted-text contrast, dark primary and destructive foregrounds, and semantic Toast readability with compatible public APIs.
Shipped- UI
- Tokens
- Accessibility
PyColors Marketing v1.23.0
The 2026-09-11 release connects the four-Block catalog, complete-source documentation, Pricing Plans, and Data Table empty-state actions while keeping application behavior consumer-owned.
Shipped- Marketing
- Blocks
- DX
Blocks discovery and complete-source documentation
Browse four documented Blocks from one catalog and copy their complete implementations from the guides. Copied source remains application-owned, without automatic updates or an installer.
Shipped- Blocks
- Docs
- DX
Pricing Plans Block
Compare offers with responsive plan cards, consumer-provided prices and billing terms, controlled period selection, and application-owned actions. The example uses fictional offers and processes no payments.
Shipped- Blocks
- Commerce
- UI
Data Table empty-state actions
Offer a first-record or filter-reset action when a ready table is empty. The application owns the callback and focus transition; loading, error, and populated states remain separate.
Shipped- Blocks
- UX
- Accessibility
PyColors Marketing v1.22.0
Shipped on 4 September 2026 with the Theme Builder, practical copyable Blocks, a current PyColors UI baseline, and a clearer path from evaluation to implementation.
Shipped- Marketing
- DX
- Trust
October 2026
PyColors Marketing v1.26.0, released on 2 October 2026, brings practical integration guidance and clearer product journeys.
PyColors Marketing v1.26.0
Released on 2 October 2026 with public AI integration guidance, clearer content discovery and purchase-recovery feedback.
ShippedDocs-based AI integration guidance
Use public PyColors guides with a coding agent today. Agent Context remains a Pilot; public Registry delivery and packaged skill evaluation are separate work.
ShippedContent-first blog and guide discovery
Browse resources before supporting product sections, and follow article actions that describe their destinations.
ShippedProduct-specific purchase recovery guidance
Select the product you need and follow conditional confirmation, retry and support guidance.
ShippedPyColors UI v1.5.5 baseline
The displayed PyColors UI baseline is v1.5.5; PyColors Tokens remains v1.2.3. No additional package version is introduced by this Marketing release.
Shipped
H1 2026
Keep the public product surface accurate, credible, and focused on shipped work.
Reusable SaaS feature showcase system
Introduced reusable Feature Showcase patterns across Starter Pro and documentation to standardize premium feature presentation, upgrade positioning, and scalable SaaS product communication.
Shipped- Starter PRO
- Patterns
- Conversion
Upgrade Gate monetization patterns
Added reusable Upgrade Gate documentation and UX guidance for production-ready premium feature gating and upgrade flows.
Shipped- Monetization
- Upgrade
- Patterns
Starter Pro product-surface refinement
Refined dashboard, pricing, billing, projects, settings, admin, and navigation surfaces to improve SaaS product maturity and premium UX consistency.
Shipped- Starter PRO
- UX
- Product
Documentation modularity and decision systems
Expanded reusable documentation structures, concept guidance, comparison systems, and decision-oriented product documentation.
Shipped- Docs
- DX
- Architecture
Authority engineering content engine
Publish high-value engineering articles around SaaS infrastructure, monorepos, CI/CD, npm publishing, release workflows, and production-ready developer systems.
Now- Blog
- Authority
- SEO
Template #2
Ship the next premium template product with docs, pricing, checkout, and delivery aligned to the existing commerce foundation.
Next- Templates
- Monetization
- Catalog
@pycolors/blocks
Package-based distribution remains planned. The current Blocks catalog provides source-copy guides, not an installable Blocks package.
Next- Blocks
- UI
- DX
Documentation-to-product conversion loop
Keep guides, patterns, Starter Free, Starter Pro, pricing, and checkout paths aligned so public product journeys stay clear.
Now- Docs
- Conversion
- SEO
Public feedback stays scoped and practical.
For UI package bugs or documentation issues, use the public repository. Broader product direction stays selective and release-driven.
Roadmap items may shift based on feedback, bugs, technical constraints, and real-world usage.