How ehsanpo/astro-template works
Main System Components
The system architecture should be divided into these key components:
a) Frontend Layer
• Main Website (Astro + React)
• Admin Panel (React/TypeScript)
• Client-side Routing
• Theme System (Dark/Light mode)
b) Content Management Layer
• Static Content (Markdown files)
• JSON Data Store
• Asset Management
c) Build & Deployment Layer
• Static Site Generation
• Asset Pipeline
• GitHub Actions Workflow
Component Relationships
[GitHub Actions] → [Build Process] → [Static Site]
• ↑
[Admin Panel] → [Content Management] → [JSON/MD Files]
• ↑
• [Assets/Images]
Detailed Component Breakdown
a) Core Applications (Rectangles):
• Blue: Main Astro Application
• Green: Admin Panel
• Purple: Build System
• Yellow: JSON Data Files
• Orange: Markdown Content
• Gray: Static Assets
c) Features (Rounded Rectangles):
• Portfolio Showcase
• Skills & Experience
• Services Section
• Contact Form
• Dark Mode Toggle
Data Flow Indicators
• Content update flow
• Build process flow
• Asset delivery
• Client-side navigation
• Theme switching
Architectural Patterns to Highlight
• Island Architecture (Astro)
• Static Site Generation
• Component-based Structure
• Content-driven Architecture
Implementation Details
a) Frontend Structure:
[Pages] → [Layouts] → [Components]
• ↑
[Styles/TailwindCSS] → [UI Components]
b) Content Management:
[Admin Panel] → [File Handlers] → [Content Files]
• → [Data JSON]
• → [Assets]
Build/Deploy Layer (Side)
This will help developers understand both the current architecture and potential areas for future expansion or modification.