How nblackburn/website works
Main Components
a. Frontend Architecture (Primary Focus)
• Astro Pages Layer
• Vue Components Layer
• Styling System (Vanilla Extract)
• Static Content (Projects/MD files)
• API Endpoints
Key Architectural Elements
a. Client Layer:
• Browser/User Interface
• Static Assets (/public directory)
b. Astro Framework Layer:
• Pages Router (/src/pages/*)
• Layouts (/src/layouts/*)
• Content Collections (/src/content/*)
c. Component Layer:
• Vue Components (/src/components/*)
• Styling System
• CSS-in-TS files (*.css.ts)
• Theme configuration
• Palette management
d. API Layer:
• Contact Form Endpoint (/api/contact.ts)
• RSS Feed Generation (/projects/rss.xml.ts)
Specific Design Elements
Use the following visual elements:
• Blue rectangles for Astro components
• Green rectangles for Vue components
• Purple rectangles for API endpoints
• Orange rectangles for static content
Component Relationships
Key interactions:
• How pages compose layouts and components
• Content collection integration with project pages
• API endpoint interaction with the contact form
• Static asset serving
• Theme/palette system integration
Important Subsystems to Highlight
a. Content Management:
• Project content structure
• Markdown processing
• Image handling
b. Styling System:
• Theme configuration
• Palette management
• Component-specific styles
c. Routing System:
• Static pages
• Dynamic project pages
• Tag-based filtering
API endpoints
• Build-time vs. Runtime components
• Static vs. Dynamic routes
• Data flow direction
• Integration points with external services
Keep the abstraction level focused on the architectural components while showing the relationship between Astro pages, Vue components, and the styling system, as these are the core technical elements of the project.
Remember to emphasize the hybrid nature of the application, showing how Astro handles static site generation while incorporating Vue for interactive components where needed.