portfolio/.planning/codebase/STACK.md

Technology Stack

Analysis Date: 2026-04-07

Languages

Primary:

• TypeScript ~5.8.0 - Full application development
• JavaScript (ES modules) - Frontend runtime

Secondary:

• HTML5 - Document structure (in index.html)
• CSS - Styling with Tailwind CSS
• Markdown - Documentation (README.md)
• YAML - Configuration (implied through Dockerfile)

Runtime

Environment:

• Node.js 22 - Development and build environment
• Browser environment - Vue 3 SFC runtime

Package Manager:

• npm - Dependency management
• Lockfile: package-lock.json (present and tracked)

Frameworks

Core Frontend:

• Vue 3.5.13 - Progressive JavaScript framework for UI
• Vue Router 4.5.0 - Client-side routing with lazy-loaded pages
• Pinia 3.0.1 - State management (minimal usage - currently only counter.ts)
• Vue I18n 9.14.4 - Internationalization (English and French locale files in src/locales/)

Build & Dev:

• Vite 6.2.4 - Build tool and dev server
  • Config: vite.config.ts with Vue plugin, DevTools plugin, chunk splitting optimization
  • Build output: dist/ with CSS code splitting, Terser minification
• Vite Plugin Vue DevTools 7.7.2 - Development utilities
• @vitejs/plugin-vue 5.2.3 - Vue 3 SFC support

Styling:

• Tailwind CSS 4.1.10 - Utility-first CSS framework
• @tailwindcss/postcss 4.1.10 - PostCSS plugin for Tailwind
• PostCSS 8.5.6 - CSS transformation pipeline
• Autoprefixer 10.4.21 - Vendor prefix handling
• Terser 5.43.1 - JavaScript minification

Code Quality:

• ESLint 9.22.0 - Linting (config: eslint.config.ts)
  • @vue/eslint-config-typescript 14.5.0
  • @vue/eslint-config-prettier 10.2.0 - Prettier integration
  • eslint-plugin-vue ~10.0.0
• Prettier 3.5.3 - Code formatting (config: .prettierrc.json)
  • Format settings: semi: false, singleQuote: true, printWidth: 100

Type Checking:

• vue-tsc 2.2.8 - Vue component type checking
• TypeScript compiler with type-check npm script

Head Management:

• @vueuse/head 2.0.0 - Dynamic document head management for meta tags and SEO

Key Dependencies

Critical:

• vue 3.5.13 - Core framework
• vue-router 4.5.0 - SPA routing with code splitting
• pinia 3.0.1 - State management store
• vue-i18n 9.14.4 - Multi-language support

Infrastructure & Build:

• vite 6.2.4 - Next-gen build tool with HMR
• tailwindcss 4.1.10 - Rapid UI development
• typescript 5.8.0 - Static typing and compilation

Developer Tools:

• eslint 9.22.0 - Code linting
• prettier 3.5.3 - Code formatting
• npm-run-all2 7.0.2 - Parallel script execution (used in build process)
• @tsconfig/node22 22.0.1 - TSConfig preset for Node 22
• @types/node 22.14.0 - Node.js type definitions
• jiti 2.4.2 - CommonJS loader for TypeScript modules

Configuration

Environment:

• No .env files detected in source
• Google Analytics tracking ID hardcoded: G-CDVVNFY6MV (in index.html)
• Umami analytics script loaded from umami.killiandalcin.fr (in index.html)
• Google AdSense client ID hardcoded: ca-pub-5219367964457248 (in index.html)

Build Configuration:

• vite.config.ts - Build optimizations:
  • Path alias: @/ → ./src/
  • CSS code splitting enabled
  • Terser minification with console/debugger removal
  • Manual chunk splitting: vue-vendor and ui-components
  • Content hash in chunk filenames for cache busting
  • Source maps disabled
  • Chunk size warning limit: 1000 KB

Type Configuration:

• tsconfig.json - References tsconfig.app.json and tsconfig.node.json
• tsconfig.app.json:
  • Extends @vue/tsconfig/dom.json
  • Includes src/**/* and *.vue files
  • Path alias: @/* → ./src/*
  • Excludes src/**/__tests__/*

Linting Configuration:

• eslint.config.ts - Flat config format:
  • Files: **/*.{ts,mts,tsx,vue}
  • Rules: Vue essential, TypeScript recommended
  • Skips Prettier formatting enforcement

Formatting Configuration:

• .prettierrc.json:
  • No semicolons
  • Single quotes for strings
  • 100 character line width

PostCSS Configuration:

• postcss.config.js - Tailwind CSS and Autoprefixer

Tailwind Configuration:

• tailwind.config.js - Content scanning for index.html and src/**/*.{vue,js,ts,jsx,tsx}

Platform Requirements

Development:

• Node.js 22+ (specified in Dockerfile)
• npm 10+ (implied by Node 22)
• TypeScript 5.8+
• Any Unix-like shell (bash/zsh) or Windows with Node.js

Production:

• Docker - Multi-stage build with Node 22-alpine and nginx stable-alpine
• Web server: nginx (configured in nginx.conf)
• Deployment target: Static HTML served via nginx
  • Base image: nginx:stable-alpine
  • Document root: /usr/share/nginx/html
  • Port: 80
  • SPA fallback: All requests route to /index.html

Browser Support:

• JavaScript enabled (noscript fallback message in index.html)
• Modern browsers with ES2020+ support (Vite default targets)

Scripts & Commands

npm run dev              # Start Vite dev server with HMR
npm run build           # Type check + build (parallel with npm-run-all2)
npm run type-check      # Run vue-tsc type checking
npm run build-only      # Build without type checking
npm run preview         # Preview production build
npm run lint            # Run ESLint with --fix
npm run format          # Format src/ with Prettier

---

Stack analysis: 2026-04-07