Flesh out recent activity component

2025-06-05 10:16:05 -07:00
parent 0b8c6c4a49
commit d8b87db784
3 changed files with 102 additions and 158 deletions
@@ -6,28 +6,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

 Flotilla is a Discord-like Nostr client that operates on the concept of "relays as groups/spaces." Built with SvelteKit 2.5 and Svelte 5, it provides messaging, threads, calendar events, and social features across Nostr relays.

-## Development Commands
-
-```bash
-# Development
-pnpm run dev          # Start dev server on port 1847
-pnpm run check        # TypeScript checking
-pnpm run check:watch  # Watch mode TypeScript checking
-
-# Production
-pnpm run build        # Custom build with env processing
-./build.sh            # Main build script with PWA assets
-pnpm run sourcemaps   # Build with sourcemap upload
-
-# Code Quality
-pnpm run lint         # ESLint + Prettier checking
-pnpm run format       # Auto-format with Prettier
-
-# Mobile
-pnpm run release:android  # Android APK build
-npx cap sync             # Sync web assets to native
-```
-
 ## Architecture

 ### Core Technology Stack
@@ -37,58 +15,18 @@ npx cap sync             # Sync web assets to native
 - **Capacitor 7** - Cross-platform mobile deployment
 - **TypeScript** - Full type safety throughout

-### Key Directories
- `/src/app/state.ts` - Global state management, stores, derived values
- `/src/app/components/` - 80+ feature-specific Svelte components
- `/src/lib/components/` - Shared/generic UI components
- `/src/routes/` - SvelteKit file-based routing with dynamic relay/room routes
- `/src/app/commands.ts` - User actions and business logic
- `/src/assets/icons/` - 60+ custom SVG icons
-
 ### State Management Patterns
 - Svelte stores with Welshman reactive patterns
 - Repository pattern for Nostr event storage with 10k event limit
 - Derived stores for computed values and real-time updates
 - Event-based architecture with reactive data flow

-### Nostr Integration Architecture
- **NIP-29 support** - Group chat functionality via relays
- **NIP-46 support** - Remote signing (Nostr Connect/Bunker)
- **Event unwrapping** - Handles gift-wrapped messages for privacy
- **Real-time relay management** - Automatic connection and authentication
- **Web of trust calculations** - User reputation and content filtering
-
-### Mobile & PWA Features
- Responsive navigation (drawer on mobile, sidebar on desktop)
- Capacitor integration for native mobile apps
- PWA with offline support and auto-updating
- Safe area handling for iOS/Android
-
-## Environment Configuration
-
-All environment variables are optional and enable platform customization:
-
-```bash
-# Branding
-VITE_PLATFORM_NAME="Custom Name"
-VITE_PLATFORM_LOGO="/custom-logo.png"
-VITE_PLATFORM_DESCRIPTION="Custom description"
-
-# Platform Mode (single-relay instance)
-VITE_PLATFORM_RELAYS="wss://relay.example.com"
-
-# Bootstrap and Discovery
-VITE_DEFAULT_PUBKEYS="npub1...,npub2..."  # Web of trust seed
-VITE_INDEXER_RELAYS="wss://indexer1.com,wss://indexer2.com"
-
-# Monitoring
-VITE_GLITCHTIP_API_KEY="..."  # Error reporting
-```
-
-The `build.sh` script processes these variables and generates theme files.
-
 ## Important Patterns

+### Finding Code
+- Prefer navigating from one file to the next following imports when possible
+- If search is necessary, use `ack`, not `grep` or `rg`.
+
 ### Component Organization
 - Components are organized by feature (Chat, Calendar, Profile, Space)
 - Use existing components from `/lib/components/` before creating new ones
@@ -103,6 +41,7 @@ The `build.sh` script processes these variables and generates theme files.
 - Events flow through the repository pattern in `state.ts`
 - Use Welshman utilities for event validation and parsing
 - Handle both plain and gift-wrapped events for privacy
+- Prefer seconds to milliseconds when handling nostr events.

 ### Styling Conventions
 - TailwindCSS with DaisyUI components