Alokai Developer Documentation Overhaul and CLI Project

Sergii

Sergii Kirianov

Alokai — Developer Documentation Overhaul + Project CLI (DX Upgrade)

✨ One-Line Summary

Rebuilt Alokai’s developer documentation using Nuxt and created a project-scaffolding CLI that reduced engineering onboarding time from 3 days to 15 minutes.

📘 About the Project

Alokai (formerly Vue Storefront) is a leading composable commerce platform used by enterprise eCommerce teams. I was hired to modernize the developer experience, which at the time suffered from outdated docs, manual onboarding steps, and unclear implementation flows.
I helped rebuilt the entire documentation website using Nuxt, improved navigation, rewrote essential guides, and introduced a custom CLI tool that automated the full setup process.
This transformed the onboarding experience for partner agencies and internal teams, reducing friction and making Alokai far more accessible to new developers.

🧩 My Role

Developer Experience Engineer / Technical Writer
Help rebuilt the documentation frontend using Nuxt from the ground up
Created a CLI tool to automate project creation & environment setup
Wrote clear guides, tutorials, and integration pathways
Improved navigation structure, cross-linking, and content clarity
Collaborated with engineering to align guides with internal best practices

📦 Deliverables

Complete Nuxt-based documentation website
New docs architecture (General → Getting Started → API → Integrations)
Major rewrite of key documentation pages
Custom CLI (npx create-alokai-app)
Automated dev environment setup
Production-ready starter templates for new projects
Faster “Getting Started” flow
Fully optimized navigation and sidebar structure

⚙️ The CLI

Developed a CLI that:
Generates a ready-to-run Alokai project
Installs dependencies automatically
Pre-configures integrations
Creates environment files
Sets up the correct file/folder structure
Launches the dev server instantly

Impact:

🔥 Reduced Time-to-Hello-World from ~3 days → 15 minutes

🛠 Tech Stack

Documentation: Nuxt, Vue, Markdown, MDX, GitHub CLI: Node.js, TypeScript, template generators Ecosystem: Vue Storefront / Alokai modules Tooling: Yarn / pnpm, Docker, GitHub Actions

📈 Results & Impact

Onboarding time for developers dropped by ~95%
Reduced dependency on engineering support for integrators
Improved clarity and usability across all documentation sections
CLI became the standard onboarding pathway
Partner agencies adopted Alokai faster with fewer mistakes
Documentation felt “modern and coherent” rather than fragmented
Like this project

Posted Nov 16, 2025

Rebuilt Alokai's developer docs with Nuxt and created a CLI, cutting onboarding time from 3 days to 15 minutes.