Interstellar Goodfellas (IGFV) — Website

Professional squadron website built with SvelteKit for the Interstellar Goodfellas Elite Dangerous squadron.

🌟 Features

• Community Hub - Member profiles, guidelines, and best practices
• Live Discord Integration - Real-time member counter powered by Discord API
• Fleet Carrier Info - Valhall details, services, and jump schedule
• Operations Board - Active missions, BGS targets, and expeditions
• Squadron News - Latest updates and announcements
• Gallery - Community screenshots and achievements
• Responsive Design - Works on mobile, tablet, and desktop with a premium dark theme

🛠️ Tech Stack

Component	Technology
Framework	SvelteKit (Svelte 5)
Language	TypeScript
Styling	Tailwind CSS v4
Animations	Svelte Transitions
Icons	svelte-awesome-icons
Deployment	Node Adapter

🚀 Quick Start

Local Development

1. Clone and install:

git clone https://github.com/VEKAgg/IGFV.git
cd IGFV
pnpm install

2. Set up environment:

cp .env.example .env.local
# Edit .env.local and add your required keys (e.g., INARA_API_KEY)

3. Run development server:

pnpm run dev
# Opens on http://localhost:5173

📋 Environment Variables

Only one environment variable is typically required for external data:

INARA_API_KEY=your_api_key_here

Get your API key from Inara Settings

🐳 Deployment

The project is configured with @sveltejs/adapter-node to run as a standalone Node.js application, making it easy to deploy with Docker or PM2.

Manual Build

pnpm run build
node build/index.js

🔧 Development Commands

pnpm run dev          # Start dev server
pnpm run build        # Build for production
pnpm run preview      # Preview production build locally
pnpm run lint         # Run ESLint and Prettier
pnpm run check        # Run svelte-check

📁 Project Structure

IGFV/
├── src/
│   ├── lib/              # Shared utilities, components, server logic
│   │   ├── components/   # Svelte components (Header, Footer, etc.)
│   │   └── server/       # Server-only libraries (e.g., db.ts)
│   ├── routes/           # SvelteKit file-based router
│   │   ├── about/
│   │   ├── gallery/
│   │   ├── fleet-carrier/
│   │   ├── operations/
│   │   ├── api/          # API routes
│   │   └── +page.svelte  # Homepage
├── static/               # Static assets
├── svelte.config.js      # SvelteKit configuration
├── vite.config.ts        # Vite build configuration
└── package.json          # Dependencies and scripts

⚡ Performance Tuning & Directus Blog Integration

This project has been updated with high-performance CSS-driven animations and client-side integration with the parent VEKA website's Directus CMS instance.

Key Changes

1. Zero-Render-Cycle Animations: Removed Svelte $state and $effect triggers from window-scroll and window-mousemove event handlers on the homepage. Positions are bound to CSS custom properties on document.documentElement (--scroll-y, --mouse-x, --mouse-y) and mapped via calc() inside styles.
2. Directus CMS News Feed: Implemented a dynamic fetch on both the homepage (announcement bar) and the bulletins board page (src/routes/news/+page.svelte) pointing to the parent CMS (https://ms.veka.gg).
3. Resilient Offline Fallbacks: The pages automatically fall back to local structured mock data if the CMS API is rate-limited, offline, or experiencing timeout errors.

Applying Code Changes

Run the following Node command in the project root directory to automatically write the optimized and integrated Svelte components into the codebase:

node -e "const fs = require('fs'); const path = require('path'); const apply = () => {
  const currentFocusPath = path.join(process.cwd(), 'src/lib/components/UI/CurrentFocus.svelte');
  if (fs.existsSync(currentFocusPath)) {
    let content = fs.readFileSync(currentFocusPath, 'utf8');
    content = content.replace('href={resolve(focus.link)}', 'href={resolve(focus.link as any)}');
    content = content.replace('bg-gradient-to-r', 'bg-linear-to-r');
    content = content.replace('bg-gradient-to-r', 'bg-linear-to-r');
    fs.writeFileSync(currentFocusPath, content);
    console.log('Fixed Type checking and Tailwind v4 linear gradients in CurrentFocus.svelte');
  }
  const claudePath = path.join(process.cwd(), 'CLAUDE.md');
  const claudeContent = fs.readFileSync(claudePath, 'utf8');
  const regex = new RegExp('\`\`\`svelte\\s*\\n([\\s\\S]*?)\`\`\`', 'g');
  let match; const specs = [];
  while ((match = regex.exec(claudeContent)) !== null) { specs.push(match[1]); }
  if (specs.length >= 2) {
    fs.writeFileSync(path.join(process.cwd(), 'src/routes/+page.svelte'), specs[0]);
    console.log('Updated src/routes/+page.svelte');
    fs.writeFileSync(path.join(process.cwd(), 'src/routes/news/+page.svelte'), specs[1]);
    console.log('Updated src/routes/news/+page.svelte');
  } else {
    console.error('Failed to parse code blocks from CLAUDE.md');
  }
}; apply();"

🎨 Color Scheme & Theme

The project uses a custom dark theme tailored for a premium space-operations aesthetic:

• Primary: Deep space blacks and slate grays
• Accents: Neon blues/reds tailored in Tailwind configuration

🤝 Contributing

For squadron members: Please follow the contribution guidelines in the Discord #dev-discussion channel.

---

Squadron: Interstellar Goodfellas (IGFV)
Founded: 2019
Fleet Carrier: Goodfellas Valhall
Discord: https://discord.gg/invite/Jvrgy6EEQn