Roadmap
What's shipped, what's in progress, what's next. We publish this so prospects can see the cadence — and so customers can anchor expectations.
Phase 1 — Core packages on npm
ShippedThree packages (@oshon-ai/tokens, primitives, components) prepped for npm with dual ESM+CJS+types, smoke-tested.
- Three core packages prepped for npm — @oshon-ai/{tokens,primitives,components}, 0.9.0-alpha.0.
- Three-seed runtime palette — applyTheme({ primarySeed, secondarySeed, tertiarySeed }) writes 44 shades in one DOM call.
- Pre-publish smoke test — scripts/smoke-test.tsx — every public surface compiles cleanly under moduleResolution: bundler.
Phase 2 — Docs site
ShippedNext.js 14 + MDX docs site. Get Started + Theming + Troubleshooting + Components catalog + Blocks library.
- Get Started walkthrough — 6 steps, Next.js + Vite + Remix + Astro install pages.
- Live theming demo — /theming with the 3-seed picker hot-wired to applyTheme().
- Component catalog — 52 components — each with its own detail page.
- Blocks library — Dashboard / Login / Settings / Pricing / Data-table compositions.
- Troubleshooting FAQ — Every common error message with the verbatim fix.
Phase 3 — Sellable
ShippedPricing page + Services catalog + draft legal artifacts so the project is invoiceable.
- Pricing tiers — Free / Pro / Enterprise. Contact-us pricing for now.
- Services catalog — Jumpstart (2 wk) / Whole Suite (6-8 wk) / Custom.
- Commercial License draft — LICENSE-COMMERCIAL.md at repo root. Requires attorney review.
- MSA + SOW templates — templates/MSA.md + templates/SOW.md with placeholder fields.
Phase 4 — Client-shipping toolkit
ShippedContract generator + client intake + white-label starter + 14-day kickoff playbook. Every step from 'lead lands' to 'invoice sent' is scripted.
- Contract generator — scripts/build-contract.mjs fills MSA + SOW from one JSON config.
- Client intake questionnaire — templates/CLIENT_INTAKE.md — 8 sections covering legal, brand, stack.
- White-label starter project — templates/client-starter — copy into client repo, edit one file, ship.
- Kickoff playbook — templates/KICKOFF_PLAYBOOK.md — day-by-day for 14 days post-signing.
- Case-study scaffold — /case-studies route ready; entries unlock as engagements close.
Phase 5 — Sales / ops scaling
ShippedReusable sales templates + pipeline tracker + monthly review. The toolkit that makes Client #2 ten times easier than Client #1.
- Email sequence library — templates/EMAIL_SEQUENCES.md — 10+ templates across 8 stages.
- Demo script — templates/DEMO_SCRIPT.md — 15-min repeatable demo with prepared Q&A.
- Reference-customer pitch — templates/REFERENCE_PITCH.md — 1-page customizable pitch citing previous customers.
- Pipeline tracker — scripts/pipeline.mjs — kanban view of every engagement, --due flag for overdue actions.
- Post-mortem template — templates/POST_MORTEM.md — captures lessons within 5 business days of each engagement.
Phase 6 — Scale-to-10
ShippedStorybook deploy + drift audit + monthly review. The maintenance layer that keeps things from drifting as you go from 2 customers to 10.
- Storybook on GitHub Pages — 55 component playgrounds, deployed on every push to main.
- Drift audit — scripts/audit-docs.mjs — nightly URL liveness + version sync + stale-case-study checks.
- Monthly review checklist — templates/MONTHLY_REVIEW.md — 60-90 min pipeline + drift + financial review.
Phase 7 — Competitive parity
In progressCatching up to shadcn / Radix / HeroUI on the developer-facing surfaces. Currently mid-execution.
- CLI rebranded to @oshon-ai/cli — License-gated component catalog, npx oshon add <name> works.
- Blocks library (5 blocks) — Dashboard / Login / Settings / Pricing / Data table.
- Multi-framework install pages — Next.js + Vite + Remix + Astro.
- Public roadmap (this page) — Replacing the privately-tracked OSHON.md.
- Icons library page — In progress.
- Charts dedicated page — In progress.
- Per-component docs polish — Anatomy diagrams + keyboard nav + CSS-var tables. In progress.
Phase 8 — Net-new components
Next upReal customer engagements will surface which components to build next. Likely candidates listed below; pull these in order of customer pull.
- TimePicker / DateRangePicker / CalendarView — Round out the date/time family currently legacy-only.
- Slider — Discrete / continuous / range — flagged P0 in the original CLAUDE.md.
- Avatar / AvatarGroup — Universally needed, currently absent.
- Combobox / Autocomplete — Free-text search Select replacement — different shape from current MultiSelect.
- Command Palette (Cmd+K) — Modern SaaS table-stakes.
- Pagination — Standalone primitive — currently only inside table block.
Phase 9 — Long tail
LaterWhen the foundation is steady and there are 5+ shipped customers. Each item here requires real adoption signal before investing.
- Public Figma kit — Source DS lives at MsyCsSxIRkgRjWd1bSJpq6 — publish a community-link version.
- Community blocks directory — shadcn-style "third-party blocks built on Oshon" submission flow.
- AI integration — Surface the @oshon-ai/mcp-server-pro publicly as an "Open in v0"-equivalent experience.
- React Native target — Sister package for mobile, mirroring the manifest contract.
- Blog — Post about architectural decisions, customer stories, releases.
Have feedback on the roadmap?
Customer pull moves items between phases. Tell us what you need and we'll explicitly factor it in.