How mholthausen/fibo works
Project type and purpose
• This is a Single-Page Application (SPA) built with React and TypeScript, bundled by Vite and deployed as a static site (Netlify).
• Its sole purpose is to let users pick Fibonacci numbers (for agile story-point estimation) via buttons and display the selected value.
File structure
• Top level
• package.json, vite.config.ts, tsconfig*.json → build tool & TS config
• netlify.toml → static-hosting/deploy rules
• index.html → SPA entry point
• public/ → raw assets (robots.txt, manifest.json, _redirects)
• src/
• main.tsx → ReactDOM.render, mount point
• App.tsx + App.css → top-level layout
• components/
– AppHeader, AppFooter
– AppContent/
· FiboButtonsToolbar/ (FiboButton, FiboPopover)
· FiboNumberDisplay
• theme.ts, utils.ts → styling tokens & helper functions
README for additional insights
• No backend services or databases—pure client-side.
• Uses Travis CI (badge in README) and Netlify (netlify.toml) for CI/CD & hosting.
Main components
A. Developer workflow
1. Developer writes code → pushes to GitHub
2. Travis CI runs lint/tests → on success triggers Netlify webhook
3. Netlify builds (Vite) → deploys to CDN
B. Runtime (Browser)
1. User’s browser requests static assets (index.html + JS bundle + CSS + assets) via CDN
2. Vite‐bundled React app mounts on
3. App → AppHeader + AppContent + AppFooter
4. AppContent → FiboButtonsToolbar (renders FiboButton, FiboPopover) + FiboNumberDisplay
5. User clicks button → React state update → display changes
Relationships & interactions
• Inside Browser: HTTP GET to CDN, then event-driven UI updates via React component tree.
• No external databases or third-party APIs.
Architectural patterns & design principles
• Component-based UI (React)
• Unidirectional data flow (React props & state)
• Static-site deployment (Jamstack): build at CI time, serve from CDN
• Typed code (TypeScript), CSS modules (per-component CSS)
Technologies / frameworks to annotate
• React / ReactDOM
• Vite (bundler)
• TypeScript
• Netlify (hosting)
• Travis CI (CI)
• ESLint (linting), Prettier (formatting, if used)