v1.6.0 released on September 5, 2025 • MIT License

Build Faster, Ship Sooner

Enterprise-grade Vite starter with TypeScript, SCSS, and professional tooling. Designed for developers who value quality, performance, and maintainability.

npm create zen@latest

Why Choose ZEN Starter?

Built with modern best practices and enterprise-grade tooling for professional development teams

Lightning Fast Development

Vite-powered HMR with instant feedback. Multi-page application support with Handlebars templating. Optimized build pipeline for production-ready deployments.

🔧

Type-Safe Architecture

Full TypeScript integration with class-based component architecture. Modular design patterns for scalable applications. Comprehensive type definitions.

🎨

Professional Styling

SCSS with PostCSS optimization. CSS-in-JS alternatives with proper scoping. Responsive design utilities and modern CSS features.

🧩

Ready Components

Production-ready interactive components: Accordion, Tabs, Modal, Theme switcher. Built with accessibility and performance in mind.

🚀

Performance Optimized

Lenis smooth scrolling integration. Optimized bundle splitting. Critical CSS extraction and lazy loading strategies.

🛠️

Developer Experience

ESLint + Prettier configuration. Hot module replacement. Comprehensive error handling and debugging tools.

Development Philosophy

The core principles and architectural decisions that make ZEN Starter exceptional. Built with modern best practices and designed for professional development teams.

Markup Structure

Semantic HTML structure with proper accessibility features, multi-page support, and Handlebars templating. Clean, maintainable markup that works everywhere.

Semantic Structure

Proper HTML5 elements with meaningful hierarchy

Multi-Page Support

Handlebars templating for multiple HTML pages

Component Templates

Reusable HTML components in dedicated folder

Progressive Enhancement

Works everywhere, enhanced where possible

Performance Markup

Optimized HTML structure for fast loading and rendering

Handlebars Templating

Powerful templating engine for dynamic content and component reuse

Styling Architecture

Modular SCSS architecture with BEM methodology, responsive design system, and modern CSS features. Built-in rem() and fluid() functions ensure consistent scaling and optimal performance.

BEM Methodology

Consistent naming with .block__element--modifier pattern

Responsive System

rem() function, fluid typography, mobile-first approach

Modern CSS

CSS Grid, Flexbox, Custom Properties, Container Queries

SCSS Modules

@use and @forward for modular architecture and dependency management

Mixins & Functions

Custom mixins for common patterns and utility functions

Variables & Theming

CSS custom properties and SCSS variables for consistent theming

Application Logic

TypeScript class-based architecture with strict type checking, modern ES6+ features, and comprehensive error handling. Each component is self-contained with clear interfaces.

Class-Based Components

Object-oriented approach with proper inheritance and lifecycle methods

Type Safety

Strict TypeScript configuration for maximum type safety and error prevention

Modern JavaScript

ES6+ features, async/await patterns, and modern DOM APIs

Bundle Optimization

Advanced optimization strategies including code splitting, lazy loading, minification, and critical CSS extraction. Built for maximum performance and minimal bundle size with Vite-powered build system.

Code Splitting

Automatic chunk optimization and dynamic imports for optimal loading

Minification

CSS and JavaScript minification with PostCSS and Vite optimization

Tree Shaking

Dead code elimination and unused export removal

Lazy Loading

Dynamic component loading and image optimization

Lenis Integration

Smooth scrolling with performance-optimized animations

Asset Optimization

Image compression, font optimization, and resource bundling

Structure

Clean, organized project structure with clear separation of concerns. Each part of the application has its dedicated place for maximum maintainability.

TypeScript Components

src/scripts/components/ - Class-based component architecture

SCSS Styles

src/styles/components/ - Modular styling system

Services & Utils

src/scripts/services/ - Business logic and utilities

Multi-page Templates

pages/ - Handlebars-powered HTML templates

Reusable Components

components/ - HTML component library

Type Definitions

src/scripts/types/ - TypeScript type definitions

Accessibility

Built-in accessibility features following WCAG 2.1 AA guidelines. Semantic HTML, ARIA attributes, keyboard navigation, and screen reader compatibility.

Semantic HTML

Proper heading hierarchy and landmark regions for screen readers

ARIA Attributes

Complex interactive elements with proper labeling and states

Keyboard Navigation

Full keyboard support for all interactive elements

Focus Management

Visible focus indicators and logical tab order

Screen Reader Support

Comprehensive support for assistive technologies

Motion Preferences

Respects user's motion preferences and reduced motion settings

Development Workflow

Lightning-fast development with Vite, PostCSS optimization, and comprehensive tooling. Hot Module Replacement, ESLint, Prettier, and TypeScript integration for professional development.

Hot Module Replacement

Instant feedback during development with Vite's HMR

PostCSS Pipeline

Autoprefixer, media query combining, and CSS optimization

Developer Tools

ESLint, Prettier, comprehensive error handling and debugging

TypeScript Integration

Full TypeScript support with strict configuration

Multi-page Support

Handlebars templating for scalable multi-page applications

Build Optimization

Production-ready builds with automatic optimization

Build Commands

Essential commands for working with the ZEN Starter build system. Everything you need to develop, build, and maintain your project.

npm run dev

Start the development server with Vite. Features hot module replacement, instant feedback, and optimized development experience.

npm run host

Start development server with network access. Allows testing on mobile devices and other machines on the same network.

npm run build

Build the project for production. Compiles TypeScript, optimizes assets, and generates production-ready files.

npm run preview

Preview the production build locally. Test the optimized version before deployment to ensure everything works correctly.

npm run lint

Run ESLint to check code quality and find potential issues. Analyzes TypeScript files for code style and best practices.

npm run lint:fix

Automatically fix ESLint issues that can be resolved. Saves time by automatically correcting common code style problems.