mirror of
https://github.com/ArthurDanjou/artsite.git
synced 2026-03-16 07:09:20 +01:00
Arthur DANJOU
5a4a4f380f
- Created CLAUDE.md to provide development commands, architecture overview, and environment variables for the Nuxt 3 portfolio website. - Refactored project pages to remove unused color mappings and improve project filtering logic. - Updated content.config.ts to enforce stricter project type definitions and added short descriptions for projects. - Deleted outdated project files and added new projects related to hackathons and academic research. - Enhanced existing project descriptions with short summaries for better clarity.
87 lines
2.6 KiB
Markdown
87 lines
2.6 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Development Commands
|
|
|
|
```bash
|
|
# Install dependencies
|
|
bun install
|
|
|
|
# Start development server
|
|
bun run dev
|
|
|
|
# Build for production
|
|
bun run build
|
|
|
|
# Preview production build
|
|
bun run preview
|
|
|
|
# Lint code
|
|
bun run lint
|
|
|
|
# Deploy to Cloudflare
|
|
bun run deploy
|
|
|
|
# Generate Cloudflare types
|
|
bun run cf-typegen
|
|
```
|
|
|
|
## Architecture Overview
|
|
|
|
This is a **Nuxt 3 portfolio website** deployed to **Cloudflare Workers** with the following architecture:
|
|
|
|
### Tech Stack
|
|
- **Framework**: Nuxt 3 (SSR/ISR with Cloudflare preset)
|
|
- **UI**: Nuxt UI v4 with Tailwind CSS
|
|
- **Content**: Nuxt Content with D1 database backend
|
|
- **Styling**: SASS (main.css) + Tailwind CSS
|
|
- **Database**: Cloudflare D1 (SQLite)
|
|
- **Cache**: Cloudflare KV
|
|
- **Icons**: Iconify
|
|
- **Composables**: VueUse
|
|
- **Validation**: Zod
|
|
- **Deployment**: Cloudflare Wrangler + NuxtHub
|
|
|
|
### Key Patterns
|
|
|
|
1. **Content Collections**: Content is organized into typed collections (projects, experiences, education, skills, contact, languages, hobbies) defined in `content.config.ts` with Zod schemas
|
|
|
|
2. **Server API Routes**: Data-fetching endpoints in `server/api/` use `queryCollection()` to fetch from D1 and return JSON to the client
|
|
|
|
3. **Composables**: Shared logic lives in `app/composables/`:
|
|
- `content.ts`: Fetches all main content collections
|
|
- `projects.ts`: Project status/type color mappings
|
|
|
|
4. **Component Structure**: Components are organized by domain in `app/components/`:
|
|
- `home/`: Homepage-specific components
|
|
- `content/`: Content projection components
|
|
- Shared components at root level
|
|
|
|
5. **Pages**: File-based routing with dynamic routes for projects (`pages/projects/[slug].vue`)
|
|
|
|
6. **Internationalization**: English/French support with content files in appropriate locales
|
|
|
|
7. **Server-side Resumes**: Static PDF resume endpoints in `server/routes/resumes/` (en.get.ts, fr.get.ts)
|
|
|
|
### Cloudflare Configuration
|
|
|
|
- **Binding**: DB (D1), CACHE (KV), ASSETS (static files)
|
|
- **Workers preset**: `cloudflare_module`
|
|
- **Exported file**: `.output/server/index.mjs`
|
|
- **Preview URLs**: Enabled for branch deployments
|
|
|
|
### Environment Variables
|
|
|
|
Required for full functionality (see `.env.example`):
|
|
- `STUDIO_GITHUB_CLIENT_ID` / `STUDIO_GITHUB_CLIENT_SECRET`: Nuxt Studio integration
|
|
- `NUXT_WAKATIME_*`: Coding statistics API keys
|
|
- `NUXT_DISCORD_USER_ID`: Discord activity display
|
|
- `NUXT_STATUS_PAGE`: Status page URL
|
|
|
|
### Build Output
|
|
|
|
- Client assets: `.output/public/`
|
|
- Server code: `.output/server/`
|
|
- Database migrations: `.output/server/db/migrations/`
|