How avictormorais/posterfy works
Project type and purpose
• Posterfy is a single-page, front-end web application built with React (JSX) and Vite.
• Its purpose is to let end-users search Spotify’s catalog, retrieve album data, and compose a custom poster via the HTML Canvas.
• There is no separate backend service—authentication keys are stored in environment variables and used by the client to call Spotify’s public API directly.
File structure
• Top level:
– package.json, vite.config.js → build tool and dependencies
– index.html → entry point for the SPA
– .env.example → template for Spotify client credentials
• src/ → application source code
– main.jsx → bootstraps React into index.html
– App.jsx, App.css → root component and global styling
– components/ → UI broken into feature folders:
· Navbar (language selector + nav links)
· Faq (Q&A panel)
· AlbumCollection, Album, DivAlbum → search results and card display
· PosterEditor (CanvasPoster + ColorSelector + input controls)
· Utility: Loading animations, search bar, Grid, Footer
– assets/ → image assets (album hero, default images)
– i18n/ → internationalization setup (i18next configuration)
• No “backend” folder or server code—calls to Spotify API are client-side via fetch.
Extract additional insights from the README
• Flow: search → select → fetch data → render on Canvas → export PNG
• Uses Spotify’s public REST endpoints (requires client ID/secret for OAuth token)
• Core technologies: React, Vite, HTML Canvas, Spotify API, i18next