Vuesion – Production-Ready Nuxt & Vue Full-Stack Boilerplate for Modern Web Apps

Vuesion is a professional, production-ready Nuxt and Vue boilerplate designed to help developers and product teams build high-quality web applications faster. It comes packed with a complete design system, modern DevOps tooling, type-safe code, authentication, SEO optimization, PWA support, and a fully structured architecture — all based on industry best practices.

Whether you're starting a SaaS app, a dashboard, a web platform, or a content-rich SEO-optimized site, Vuesion gives you the perfect foundation to start building immediately.

🚀 What You Get Out of the Box

Full-stack Nuxt application with SSR, SPA, and Static modes
Complete design system with 35+ accessible and customizable UI components
Built-in Theming & White Labeling with design tokens
SEO-friendly setup with meta tags, OG tags, structured layout, and server rendering
Authentication powered by sidebase Nuxt Auth
Internationalization (i18n) with Nuxt i18n
Progressive Web App (PWA) module for offline-ready experiences
Code generators for pages, components, APIs, and stores
Storybook for UI documentation and collaborative workflows
Form validation with vee-validate
Smooth animations using Anime.js
Complete testing setup — Cypress, Vitest, Testing Library (250+ sample tests)
Exceptional developer experience: TypeScript, ESLint, Prettier, commit hooks, semantic release
Docker-ready production configuration

🎯 Ideal Use Cases

Vuesion is perfect for:

SaaS startups building dashboards, admin apps, or multi-tenant platforms
Teams that want a scalable Vue/Nuxt architecture without spending months on wiring setups
Agencies looking for a reusable, customizable boilerplate
SEO-focused websites needing speed, server-side rendering, and rich metadata
Enterprise teams standardizing their front-end with a design system and consistent DX
Developers who need a powerful Nuxt starter kit with best practices included

🛠 Tech Stack Overview

Languages & Frameworks

Vue 3
Nuxt
TypeScript
SCSS

Core Modules

Pinia (state management)
sidebase Nuxt Auth (authentication)
Nuxt i18n (localization)
Nuxt PWA (offline support)
Storybook (design system docs)
vee-validate (forms)
Anime.js (animations)

Developer Tooling

Vite
Cypress
Vitest
Testing Library
ESLint + Prettier
Husky + Commitlint
Semantic Release
Hygen generators

Database & Backend

Prisma ORM
PostgreSQL (default example)

Ops, Deployment & Config

Dockerfile included
Example deployment using Heroku
.env based config

🧩 How to Get Started

Option 1: Generate a New Project

Install Node.js
Run the official generator:
```
npx @vuesion/create my-app
```
Install dependencies:
```
npm install
```
Copy .env-example → .env
Start development:
```
npm run dev
```
Start Storybook:
```
npm run storybook:dev
```

Option 2: Clone the Repo

git clone https://github.com/vuesion/vuesion.git
cd vuesion
npm install
npm run dev

Configure environment variables and extend the boilerplate with your custom features.

📁 Project Structure

src – core app (pages, components, layouts, stores)
prisma – DB schema & migrations
cypress – e2e tests
.storybook – Storybook config
i18n – translations
_templates – code generators

📌 Important Notes

License: MIT — free for commercial use
Design system: Fully customizable, with a matching Figma UI Kit
Database: Prisma + PostgreSQL by default
Auth: Configurable via sidebase Nuxt Auth
Testing: 250+ example tests included
Purpose: Acts as a scalable boilerplate ready for SaaS, dashboards, or large web apps

Screenshots