How sebastiansierra15/udlaverso-frontend works
Project Type & Purpose
• Type: A single-page application (SPA) built with React, TypeScript, Vite, Tailwind CSS, following an Atomic Design component structure.
• Purpose: A marketing/documentation site (with pages like “AcercaDe,” “FAQ,” “Noticias,” “Proyectos,” etc.), deployed as static assets (Netlify).
File Structure
Top-level areas:
• public/ – Static assets (images, videos, logos) served as-is
• src/
– main.tsx + index.html + index.css: app entry point + global styles
– pages/ – Route pages (one per URL path)
– components/ – UI layer organized by Atomic Design:
· atoms → molecules → organisms → templates (in “templates” subfolders)
– assets/, content/ & utils/
• Configuration & build scripts:
– vite.config.ts, tailwind.config.js, postcss.config.js, eslint.config.js, netlify.toml
README for Insights
• Confirms Vite with React plugin, HMR, ESLint rules, optional React Compiler.
• No backend or API calls are referenced—this is purely frontend/hosting.
Main Components and Their Relationships
A. Development & Build Pipeline
1. Developer edits .tsx/.ts files in src/
2. Vite Dev Server provides HMR for local testing
3. On build, Vite + PostCSS + Tailwind generate optimized bundles
4. Netlify CI/CD picks up dist/ and deploys to a CDN
B. Runtime (Client-side)
1. User’s browser fetches index.html + JS/CSS bundles from CDN
2. React Router in main.tsx mounts App.tsx
3. App renders Page components (in src/pages/) based on URL
4. Pages compose Organisms → Molecules → Atoms components
5. Assets (images, videos) are loaded from /public via static routes
C. Design Pattern
Atomic Design:
– Molecules: small groups of atoms (input groups, card snippets)
– Organisms: larger sections (headers, footers, hero sections)
– Templates/Pages: route-level layouts and content composition
Key Technologies & Frameworks
• React + TypeScript for UI & type safety
• Vite for fast development and build
• Tailwind CSS + PostCSS for styling
• ESLint (with optional React/TypeScript plugins)
• Netlify for static hosting & CDN
Essential Details to Capture
• Vite Dev Server & Plugins (fast refresh, ESLint)
• Build → dist/ artifacts → Netlify deploy
• CDN distribution of JS/CSS/assets
• React App bootstrapped by main.tsx → App.tsx
• Routing layer (pages folder)
• Atomic Design component flow: Atoms → Molecules → Organisms → Templates → Pages
• Tailwind & PostCSS pipeline