What's inside?
Tech Stack
- Frontend: Svelte 5 + SvelteKit + TypeScript + Tailwind CSS 4 + shadcn-svelte + Lucide Svelte + Superforms + Valibot
- API: Supabase (PostgreSQL, Auth, Realtime, Storage)
- Build System: Turborepo + Bun + Vite
- Quality Tools: ESLint 9, Prettier, CSpell, markuplint
- Development: VS Code extensions, lint-staged, husky, GitHub Actions
Apps and Packages
apps/
-
api
Supabase Local Development
PostgreSQL database, authentication, and API services -
web
SvelteKit Frontend
Modern web application with page-based component organization, class-based design patterns, and comprehensive Supabase integration -
pages
Static Site Publishing
High-quality static websites with URL validation, accessibility checks, and SEO optimization
packages/
-
shared
Shared components, styles, types, constants, and utilities
- UI Components: shadcn-svelte components and custom components
- Styles: app.css - Base Tailwind CSS styles
- Shared logic: Types, constants, and utility functions
-
eslint-config
Centralized ESLint 9 configuration with Flat Config
- eslint-config-prettier - Prettier integration
- eslint-plugin-svelte - Svelte linting
- eslint-plugin-simple-import-sort - Import sorting
- eslint-plugin-jsdoc - JSDoc validation
- eslint-plugin-unused-imports - Unused import cleanup
Commands
# Install dependencies (.env file is created automatically)
bun install
cd apps/pages
# For static site development
bun run dev # Start development server (port 3000)
bun run build # Build static site with Tailwind CSS
# Quality assurance for pages
bun run test # Validate links, images, and accessibility
bun run test:watch # Run tests in watch mode
bun run test:update # Update test snapshots such as tests/external-links.txt
bun run lint # Run HTML validation with markuplint
bun run format # Format with Prettier
# Publishing
bun run deploy # Deploy public/ to your server with rsync
# Optimization Utilities
bun run add-size-to-img # Add width/height to <img> tags for better performance
bun run clean-images # Remove unused images from project
bun run clean-images --dry-run # Preview unused image removals