aethex-us/.github/copilot-instructions.md

64 lines
2.3 KiB
Markdown

# AeThex.us Copilot Instructions
## Project Overview
AeThex.us is the main website for AeThex, built with Astro. The platform is organized into three Trinity divisions:
- **Foundation** (Red) - Education, community programs, and mentorship for developers
- **Corporation** (Blue) - Technology conglomerate powering digital ecosystems and platforms
- **Labs** (Yellow) - The Grid bounty platform for creators to ship code and earn rewards
## Tech Stack
- **Framework**: Astro 5.x (static site generator)
- **Styling**: CSS with custom properties, no CSS frameworks
- **Fonts**: System fonts + JetBrains Mono for code
- **Icons**: Emoji-based icons throughout
## Project Structure
```
src/
├── components/ # Reusable Astro components
├── layouts/ # Page layouts (MainLayout.astro)
├── pages/ # All page routes
│ ├── index.astro # Homepage
│ ├── foundation.astro # Foundation division
│ ├── corporation.astro # Corporation division
│ ├── labs.astro # Labs division (The Grid)
│ ├── gameforge.astro # GameForge product (Labs)
│ └── docs/ # Documentation pages
public/
├── favicon.svg # Trinity circles logo
├── global.css # Global styles
└── *.svg # Logo assets
```
## Development Commands
```bash
npm install # Install dependencies
npm run dev # Start dev server (localhost:4321)
npm run build # Build for production
```
## Design Guidelines
- **Trinity Colors**: Red (#FF0000), Blue (#0066ff), Yellow (#EAB308)
- **Dark Theme**: Primary backgrounds #0a0a0a, #0f0f0f, #1a1a1a
- **Responsive Breakpoints**: 1024px (tablet), 768px (mobile), 480px (small)
- **Animations**: Subtle CSS transitions, avoid heavy JavaScript animations
## Key Conventions
1. Each Trinity page has a distinct visual identity matching its purpose
2. Use scoped `<style>` blocks in Astro components
3. Mobile-first responsive design with comprehensive breakpoints
4. Keep external dependencies minimal
5. All educational content is free (Foundation mission)
## Notes
- GameForge is a **Labs product**, not a Trinity division
- The favicon shows three overlapping circles (Red, Blue, Yellow)
- Partner logos in public/ folder are placeholder SVGs