Tutorials π
Learn Presetter through practical, hands-on guides. Each tutorial walks you through real-world scenarios with complete examples and interactive tools.
Presetter Configuration Generator
Choose your preset stack. Run the command in a project with a package.json; use installs the packages, adds declared scripts, and bootstraps the configs.
Installation Command
pnpm dlx presetter use @presetter/preset-esm @presetter/preset-strict --package-manager=pnpm
presetter.config.ts
import preset0 from '@presetter/preset-esm';
import preset1 from '@presetter/preset-strict';
import { preset } from 'presetter';
import { name } from './package.json' with { type: 'json' };
export default preset(name, {
extends: [preset0, preset1],
});
The config above previews the file written by use. It also adds the presetsβ declared dependencies, devDependencies, peerDependencies and package scripts. Essentials includes Vitest and the TypeScript 7 CLI alongside the TypeScript 6 API. Existing declarations and scripts are preserved; conflicting package specifications are reported.
The package manager declared by your project or selected by its lockfile takes priority over the commandβs fallback flag.
- Run the installation command above
- Approve dependency builds if your package manager requests it
- Keep customizations in presetter.config.ts, then rerun bootstrap
- Start developing with your configured tooling!
Getting Started Tutorialsβ
π New Project Setupβ
Time: 3-5 minutes | Level: Beginner
Complete walkthrough for starting a new TypeScript project with Presetter from scratch. Perfect for developers new to Presetter who want to get up and running quickly.
What you'll learn:
- Installing and configuring Presetter
- Understanding preset selection
- Setting up your development workflow
- Testing and building your project
π Migrating Existing Projectsβ
Time: 15-30 minutes | Level: Intermediate
Step-by-step guide to convert existing projects to use Presetter configurations while preserving your custom settings and maintaining compatibility.
What you'll learn:
- Assessment and backup strategies
- Configuration migration patterns
- Handling dependencies and scripts
- Troubleshooting common issues
Project Type Tutorialsβ
π’ Monorepo Setupβ
Time: 30-45 minutes | Level: Advanced
Configure a multi-package workspace with shared Presetter configurations. Learn to manage complex projects with multiple packages and cross-dependencies.
What you'll learn:
- Workspace configuration with pnpm
- Shared vs. package-specific configurations
- Build orchestration and dependency management
- Cross-package development workflows
π¨ Creating Custom Presetsβ
Time: 2-4 hours | Level: Advanced
Build your own Presetter presets for team-specific requirements. Create reusable configurations that encapsulate your organization's standards and best practices.
What you'll learn:
- Preset architecture and design patterns
- Configuration factories and templating
- Testing and publishing presets
- Advanced features and conditional logic
π€ Sharing Coding Agent Setup Across Reposβ
Time: 30-60 minutes | Level: Advanced
Use a custom preset to share coding-agent instructions, plugins, skills, MCP configuration, and modular template files across repositories without copying the same files repo by repo.
What you'll learn:
- Encoding coding-agent setup as preset assets
- Sharing
CLAUDE.md-style instructions across repos - Standardizing plugins, skills, and MCP definitions
- Mixing inline config with template-file paths for modular agent setup
- Keeping a shared baseline with repo-specific overrides
Migration Guidesβ
π― From Create React Appβ
Time: 2-4 hours | Level: Intermediate
Transform your Create React App project to use Presetter's modern, flexible tooling. Unlock full configuration control and significantly improve build performance.
Benefits:
- β 5-10x faster builds with Vite
- β Full TypeScript strict mode
- β Modern development server with HMR
- β Complete configuration control
π¦ Migration Guide Overviewβ
Comprehensive guides for migrating from various tools and setups:
- Create React App β Modern Vite + Presetter setup
- Vite β Enhanced tooling with Presetter ecosystem
- Manual configurations β Managed Presetter workflow
β‘ Presetter Command Helper
Generate the right Presetter command for your needs:
Description:
Initialize Presetter configuration and generate all config files
π― Generated Command
pnpm exec presetter bootstrap
π‘ More Examples
presetter bootstrap
presetter bootstrap "packages/*"
presetter bootstrap --package "@scope/*"
- bootstrap: Set up initial configuration files
- run: Execute a single script with optional arguments
- run-s: Run scripts one after another (sequential)
- run-p: Run scripts at the same time (parallel)
Interactive Learning Toolsβ
π§ Configuration Generatorβ
Use the interactive tool above to generate custom Presetter configurations based on your project requirements. Perfect for understanding which presets you need.
β‘ Command Helperβ
The command helper tool shows you the exact Presetter commands for different scenarios, with examples and explanations.
Tutorial Progression Pathsβ
π― Beginner Path (30 minutes)β
- New Project Setup - Get familiar with Presetter basics
- Try the Configuration Generator - Understand preset options
- Practice with the Command Helper - Learn CLI usage
π Intermediate Path (2-3 hours)β
- Existing Project Migration - Apply to real projects
- Migration Guides - Framework-specific scenarios
- Advanced configuration customization
π¨ Advanced Path (4-6 hours)β
- Monorepo Setup - Complex project management
- Custom Preset Creation - Build team standards
- Sharing Coding Agent Setup Across Repos - Distribute agent standards cleanly
Real-World Examplesβ
Quick Start Examplesβ
# React Application
pnpm add -D presetter @presetter/preset-react
presetter bootstrap
# TypeScript Library
pnpm add -D presetter @presetter/preset-essentials @presetter/preset-esm
presetter bootstrap
# Monorepo Workspace
pnpm add -D presetter @presetter/preset-monorepo
presetter bootstrap
Common Use Casesβ
π Web Applicationsβ
- React/Vue single-page applications
- Static site generators
- Progressive web apps
π Libraries & Packagesβ
- NPM packages with TypeScript
- Component libraries
- Utility libraries with dual module support
π’ Enterprise Projectsβ
- Multi-package monorepos
- Shared configuration standards
- Team development workflows
Getting Helpβ
π Stuck? Get Supportβ
- GitHub Issues - Bug reports and feature requests
- GitHub Discussions - Community help and questions
- API Documentation - TypeScript API reference
π Additional Resourcesβ
- Configuration Reference - All available presets
- CLI Reference - Complete command documentation
- Best Practices - Tips and optimization guides
π€ Community Examplesβ
Ready to start? Choose a tutorial that matches your experience level and project needs. Each guide includes working examples, troubleshooting tips, and next steps to help you succeed with Presetter.