{"id":29770566,"url":"https://github.com/deaneeth/web_portfolio","last_synced_at":"2025-09-21T23:03:47.511Z","repository":{"id":305411109,"uuid":"1011199304","full_name":"deaneeth/web_portfolio","owner":"deaneeth","description":"A personal portfolio featuring an advanced AI-powered easter egg and personalized AI Agent system with gamification, curiosity trails, and interactive discovery mechanics.","archived":false,"fork":false,"pushed_at":"2025-09-09T11:31:44.000Z","size":706,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-09T14:30:50.814Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deaneeth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-30T13:02:14.000Z","updated_at":"2025-09-08T18:01:29.000Z","dependencies_parsed_at":"2025-09-02T13:16:02.821Z","dependency_job_id":"00c890ae-69a5-43a5-bfb4-070ac91f3ea9","html_url":"https://github.com/deaneeth/web_portfolio","commit_stats":null,"previous_names":["deaneeth/web_portfolio"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deaneeth/web_portfolio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fweb_portfolio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fweb_portfolio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fweb_portfolio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fweb_portfolio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deaneeth","download_url":"https://codeload.github.com/deaneeth/web_portfolio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fweb_portfolio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276318991,"owners_count":25621652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-21T02:00:07.055Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-27T05:40:53.955Z","updated_at":"2025-09-21T23:03:47.506Z","avatar_url":"https://github.com/deaneeth.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dean's Portfolio - Enhanced AI Easter Egg \u0026 AI Chat Agent Experience\n\nA personal portfolio featuring an advanced AI-powered easter egg and personalized AI Agent system with gamification, curiosity trails, and interactive discovery mechanics.\n\n\u003e This Project is currently under-development\n\n## 🎮 Enhanced Easter Egg Features\n\n### 🔍 Curiosity Trail System\n- **Multiple Discovery Points**: Three hidden triggers throughout the About section\n  - Main trigger in \"Who I Am\" card\n  - Skills trigger in the core skills grid\n  - Journey trigger in the timeline section\n- **Progressive Discovery**: Each trigger unlocks new personality modes for ARIA\n- **Visual Feedback**: Discovered triggers show animated indicators and special effects\n\n### 🏆 Gamification Elements\n- **Progress Tracking**: Visual progress bar showing \"X of Y secrets found\"\n- **Milestone Rewards**: Special animations and sounds for discovery milestones\n- **Achievement System**: \"Curiosity Master\" status when all secrets are found\n- **Session Memory**: Tracks discoveries and facts shown during the session\n\n### 🎨 Dynamic Visual Experience\n- **Contextual Icons**: Each fun fact displays a relevant animated icon (music notes, code symbols, etc.)\n- **Animated Typing**: Real-time typewriter effect for all ARIA responses\n- **Constellation Mode**: Particle effects when all secrets are discovered\n- **Adaptive UI**: Interface changes based on discovery progress\n\n### 🔊 Enhanced Sound Design\n- **Contextual Audio**: Different sounds for discovery, milestones, typing, and interactions\n- **Accessibility Controls**: Sound toggle with visual indicators\n- **Sci-fi Aesthetic**: Subtle, pleasant notification sounds using Web Audio API\n- **Progressive Audio**: Sound complexity increases with discovery progress\n\n### 🤖 ARIA Personality System\n- **Mood States**: ARIA's personality evolves based on user interaction\n  - Curious (first interaction)\n  - Excited (first discovery)\n  - Playful (multiple discoveries)\n  - Amazed (all secrets found)\n- **Contextual Responses**: Different greeting messages based on discovery progress\n- **Witty Commentary**: ARIA adds personality quirks and digital \"high fives\"\n\n### 🧠 Smart Memory \u0026 AI Integration\n- **Session Tracking**: Remembers shown facts to avoid repetition\n- **Intelligent Rotation**: Adapts fact selection based on discovery progress\n- **Question Mode**: Users can ask custom questions about Deaneeth\n- **Fallback System**: Enhanced offline facts with discovery-aware responses\n\n## 🛠 Technical Implementation\n\n### File Structure\n```\nnetlify/functions/\n  └── groq-funfact.js          # Enhanced serverless function with personality modes\n\ncomponents/easter-egg/\n  └── curiosity-trigger.tsx    # Advanced easter egg component with gamification\n\ncomponents/sections/\n  └── about-section.tsx        # About section with multiple discovery points\n```\n\n### Key Technologies\n- **Framer Motion**: Advanced animations and micro-interactions\n- **Web Audio API**: Contextual sound design with accessibility controls\n- **Local Storage**: Persistent discovery state across sessions\n- **Groq API**: AI-powered fact generation with personality context\n- **TypeScript**: Type-safe implementation with proper interfaces\n\n### Accessibility Features\n- **Keyboard Navigation**: Full keyboard support for all interactions\n- **Screen Reader Support**: Proper ARIA labels and descriptions\n- **Sound Controls**: Toggle for audio with visual feedback\n- **Focus Management**: Proper focus trapping in modals\n- **Reduced Motion**: Respects user motion preferences\n\n## 🚀 Setup Instructions\n\n### 1. Environment Configuration\nSet up your Groq API key in Netlify:\n1. Go to Site Settings \u003e Environment Variables\n2. Add `GROQ_API_KEY` with your Groq API key\n3. Deploy the site to activate the serverless function\n\n### 2. Discovery Experience\nUsers can discover the easter egg by:\n1. Finding the animated sparkle icons in the About section\n2. Clicking each trigger to unlock new ARIA personality modes\n3. Progressing through the curiosity trail to unlock all secrets\n4. Achieving \"Curiosity Master\" status for the ultimate experience\n\n### 3. Customization\n- **Personality Modes**: Modify ARIA's responses in the serverless function\n- **Discovery Points**: Add new triggers by placing `\u003cCuriosityTrigger\u003e` components\n- **Sound Design**: Customize audio frequencies and patterns in the component\n- **Visual Effects**: Adjust animations and particle effects in the modal\n\n## 🎯 User Experience Flow\n\n1. **Discovery**: User notices subtle, animated sparkle icons\n2. **First Interaction**: ARIA introduces herself with curiosity\n3. **Progressive Engagement**: Each discovery unlocks new personality modes\n4. **Milestone Celebrations**: Special effects and sounds for achievements\n5. **Ultimate Revelation**: Constellation mode and \"Curiosity Master\" status\n6. **Continued Interaction**: Question mode and infinite fact exploration\n\n## 🔧 Advanced Features\n\n### Personality Context System\nThe AI adapts its responses based on:\n- Number of secrets discovered\n- User interaction patterns\n- Session history and engagement\n- Discovery milestone achievements\n\n### Visual Feedback System\n- **Trigger States**: Visual indicators for discovered vs undiscovered\n- **Progress Visualization**: Animated progress bars and counters\n- **Contextual Icons**: Dynamic icon selection based on fact content\n- **Particle Effects**: Celebration animations for major milestones\n\n### Sound Architecture\n- **Layered Audio**: Multiple oscillators for rich, harmonic sounds\n- **Contextual Timing**: Different durations and patterns for different actions\n- **Accessibility First**: Easy toggle with visual feedback\n- **Performance Optimized**: Efficient Web Audio API usage\n\n---\n\nThis enhanced easter egg system demonstrates advanced React patterns, AI integration, gamification principles, and premium UX design while maintaining the site's futuristic aesthetic and accessibility standards.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeaneeth%2Fweb_portfolio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeaneeth%2Fweb_portfolio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeaneeth%2Fweb_portfolio/lists"}