Skip to content
Astro Performance Starter

Custom Scripts

This project uses a collection of custom scripts to automate common tasks, enforce quality standards, and enhance the build process.

Development Scripts

Section titled “Development Scripts”
CommandDescription
startStart development server
start:hostStart development server with network access
start:debugStart development server with verbose logging
previewPreview production build locally
cleanRemove build artifacts (dist, .astro)
clean:allRemove build artifacts and node_modules cache

Build Scripts

Section titled “Build Scripts”
CommandDescription
buildBuild tokens then build site for production
build:ciBuild for CI with verbose logging
tokens:buildCompile design tokens to CSS variables and Tailwind config

Code Quality Scripts

Section titled “Code Quality Scripts”
CommandDescription
formatFormat code with Biome
format:checkCheck code formatting without changes
lintLint code with Biome
lint:mdLint Markdown files
lint:md:fixFix Markdown linting issues
typecheckRun Astro type checking
typecheck:typesRun TypeScript type checking only
qualityRun all quality checks (format, lint, markdown, types)

Testing Scripts

Section titled “Testing Scripts”
CommandDescription
testRun unit tests with Vitest
test:unitRun unit tests once
test:e2eRun Playwright end-to-end tests
test:e2e:uiRun E2E tests with UI
test:a11yRun accessibility tests

Documentation Scripts

Section titled “Documentation Scripts”
CommandDescription
docs:syncSync documentation from separate docs repo (available at launch)
docs:updateSync docs and inject current package versions for AI context
docs:componentsStart Astrobook component documentation
docs:components:buildBuild Astrobook documentation
roadmap:updateUpdate implementation roadmap status

Performance Scripts

Section titled “Performance Scripts”
CommandDescription
images:analyzeAnalyze image sizes and optimization opportunities
images:optimizeInteractive image optimization tool
bundle:analyzeAnalyze bundle size and composition
perf:budgetsCheck performance against defined budgets
perf:baselineTrack baseline performance metrics
perf:lighthouseRun Lighthouse performance audit
perf:lighthouse:ciRun Lighthouse for CI (JSON output)

Design System Scripts

Section titled “Design System Scripts”
CommandDescription
design:validateValidate color contrast compliance (WCAG AA)
budgets:validateValidate performance budget overrides

Security Scripts

Section titled “Security Scripts”
CommandDescription
auditRun security audit on production dependencies
audit:ciRun filtered security audit for CI

Git Hooks

Section titled “Git Hooks”
CommandDescription
prepareInstall Husky git hooks