The Skeleton directory contains our production-ready template featuring:
Backend Foundation:
- Abstract router template with 3 customizable methods for AI behavior
- Base configuration system that apps extend with their own settings
- Gemini AI client with error handling and response parsing
- Common Pydantic models (FlowStep, FlowOption, etc.) shared across apps
- Utility functions for JSON parsing, validation, and data sanitization
- FastAPI app factory with CORS middleware and health checks
Frontend Foundation:
- Base API service classes with timeout handling and error management
- React hooks for common API interactions and state management
- TypeScript interfaces matching backend models
- TailwindCSS configuration with extensible themes
- Deployment configurations ready for Railway + Netlify
๐ Complete Documentation & Usage Examples โ
๐ง Logic Hinter - โจWorld's first everโจ coding AI that NEVER GIVES CODE
The Problem: Stuck on a LeetCode problem? Don't want to see the solution directly and ruin your learning? YouTube tutorials show you the code, AI chat gives you the answer, but nobody allows YOU to think through a problem?
Our Solution: Logic Hinter is the world's first AI that NEVER GIVES CODE - only guides your reasoning. A patient mentor who helps you think step-by-step, not copy.
Why It's Revolutionary:
- ๐ก Pure Logic Training - Builds algorithmic code thinking, not copy-paste habits.
- ๐ Smart Learning Links - Provides curated educational resources but never direct code solutions.
- ๏ฟฝ Earn Your Resources - Get helpful learning resources only AFTER making the right reasoning choice.
- ๐ฏ Two Learning Modes - "Naive" (explore basics) and "Optimized" (efficiency-focused)
Perfect For: Developers who want to actually understand algorithms, not just memorize solutions.
๐ Study Hinter - Interactive General Knowledge for Kids
An intelligent General Knowledge companion for children that generates quiz questions and provides adaptive "mistake-based" learning guidance. Transform any topic into an engaging learning experience.
Key Features:
- ๐ง AI-Generated Questions - Custom quizzes for any topic
- ๐ Adaptive Difficulty - Below Grade 6 vs Above Grade 6 modes
- โญ Star-Based Scoring - Mistake-based learning (4โ3โ2โ1 stars per wrong option selection)
- ๐ผ๏ธ Visual Learning - Images for each answer option via Unsplash integration for children.
- ๐ Spooky Theme - Engaging Halloween-inspired design
Our foundation of "option-based" learning can power diverse AI applications:
- ๐ฎ Interactive Adventure Games - Choose-your-own-adventure with consequences
- ๐ฅ Medical Training Platforms - Diagnostic reasoning for healthcare professionals
- ๐ Language Learning Apps - Conversation scenarios and cultural context
- ๐ผ Professional Development - Workplace skills and decision-making frameworks
- ๐งฎ Educational Tools - Math, science, and academic subject tutoring
- ๐ฏ Skill Assessment - Interactive evaluations and personalized feedback
The Challenge: Stitch together a chimera of technologies into one app. Bring together seemingly incompatible elements to build something unexpectedly powerful.
Our Creation: We've merged Python FastAPI backends with React/TypeScript frontends, integrated Gemini's models with custom logic engines, and combined real-time AI processing with polished UI/UX. The result? Two distinct applications that seamlessly blend:
- ๐ Python + FastAPI (Backend)
- โ๏ธ React + TypeScript/JSX (Frontend)
- ๐ค Gemini (AI Intelligence)
- ๐จ TailwindCSS + Custom Animations (Spooky UI)
- โ๏ธ Railway + Netlify (Cloud Deployment)
The Challenge: Build any app but show us a haunting user interface that's polished and unforgettable. Bring in spooky design elements that enhance your app's function.
Our Spooky Design Elements:
- ๐ Dark, atmospheric color schemes (purple for Logic, green for Study)
- โจ Smooth fade-in animations and transitions
- ๐ธ๏ธ Glowing effects and shadow layers
- ๐ Themed emoji and iconography
- ๐ญ Polished, professional layouts with Halloween flair
- ๐ซ๏ธ Gradient backgrounds that evoke mystery
Both applications feature carefully crafted interfaces that don't just look spookyโthey enhance usability through thoughtful design choices, smooth interactions, and clear visual hierarchy.
Experience the apps yourself:
- Logic Hinter: https://app1kiro.netlify.app/
- Study Hinter: https://app2kiro.netlify.app/
- True Versatility: One skeleton, two completely different applications with distinct purposes
- AI-Powered: Leveraging Gemini for intelligent, context-aware responses
- Production-Ready: Deployed and accessible with proper CI/CD pipelines
- Design Excellence: Spooky aesthetics that enhance rather than distract
- Clean Code: Modular, maintainable, and well-documented
Each application can be run independently:
cd app1-LogicHinter/backend # or app2-StudyHinter/backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reloadcd app1-LogicHinter/frontend # or app2-StudyHinter/frontend
npm install
npm run dev- โ Frankenstein: Multi-technology integration
- โ Skeleton Crew: Reusable template with two applications
- โ Costume Contest: Polished, haunting UI/UX
This project is licensed under the MIT License - an OSI-approved open source license.
See the LICENSE file for full details.
TL;DR: Free to use, modify, and distribute. No strings attached. ๐ป
Built with ๐Kiro for Kiroween Hackathon