How pedroermarinho/site works
Project Type and Purpose
• This is a Flutter application that serves as a personal portfolio site developed by Pedro Marinho. It targets multiple platforms (Android, iOS, Linux desktop, and Web) and showcases personal projects, academic details, work experience, and more.
• The README clearly states that it’s a “Portfolio” and gives installation instructions using “flutter run”. The presence of platform-specific directories (android, ios, linux, web) confirms the cross-platform nature of the application.
Analysis of the File Structure
• Top-Level Directories: Notice directories like “android”, “ios”, “linux”, “web” which indicate the cross-platform builds.
• The main Flutter code resides in the “lib” directory. Inside “lib/app” the code is split into several subdirectories:
• “config”: holds application configuration (constants, assets paths, environment, error configurations).
• “data”: holds repositories (for GitHub data, markdown, settings, theme) and services (like storage service). These represent data access layers for external (or local) data.
• “domain”: contains entities, errors, use cases, and view models. This represents the business logic layer following a clean architecture approach.
• “ui”: represents the presentation layer with different pages (home, markdown, projects, settings) and components. It also includes shared components and widgets.
• “utils” and “generated”: additional helper classes and automatically generated code.
• The test directory mirrors the structure for unit tests for repositories and use cases.
Specific Elements
• Clear labels for each component, for example: “Platform (Android/iOS/…)", “Flutter App Entry (main.dart)”, “UI Layer”, “ViewModels”, “Domain/Use Cases”, “Data Repositories (GitHub, Markdown, Settings, Theme)”, “Local/Remote Services”, “Configuration & Utilities”.
• From UI -> ViewModels -> Use Cases -> Repositories -> Services.
• Feedback loops for error handling and configuration.
• Optionally, include annotations for key technologies like Flutter, Dart, and any notable libraries (e.g., PDF generation utilities).