codex-lv2-may-2025

# 🎯 Capstone Project: [Your Project Name]

## 📖 About  
Describe your project here. What does your application do? What APIs and AI features does it integrate? Why is it useful or interesting?  

---

## 🚀 Getting Started  

### Prerequisites  
- Web browser (Chrome, Firefox, Edge)  
- Node.js (for running `npx live-server`)  
- API keys for your chosen services (weather, Pokemon, etc.)
- Hugging Face account and API token

### Setup Steps  
1. Clone or download this repository.  
2. Open a terminal in the project folder.  
3. Run the project locally with:  
   ```bash
   npx live-server
   ```  
4. Open the URL shown in your terminal (usually `http://127.0.0.1:8080`).  

---

## 🛠️ Tech Used  
- **HTML**: Structure and semantic markup
- **CSS / Bootstrap**: Responsive styling and layout  
- **JavaScript**: App logic, event handling, API calls, AI integration
- **helpers.js**: Utility functions for working with the DOM  
- **External APIs**: Weather, Pokemon, or other data services
- **AI Integration**: Hugging Face models for enhanced functionality
- **Git / GitHub**: Version control and project management

---

## 📋 Features  
- Responsive Bootstrap UI with custom styling
- External API integration (weather, Pokemon, etc.)
- AI model integration for enhanced user experience
- Input validation and error handling
- Dynamic user interactions and data processing
- Professional error messages and user feedback
- Mobile-responsive design

---

## ✅ Project Checklist  

 - [X] **README.md** A README with a checklist.

### Core Functionality
- [ ] **User Interface**: Clean, responsive Bootstrap UI with proper styling *(Complete after Level 7)*
- [ ] **Interactive Features**: Buttons and inputs that listen and respond to actions from the user *(Complete after Level 9)*
- [ ] **API Integration**: Successfully connects to external API and displays data *(Complete after Level 15)*
- [ ] **AI Integration**: Implements AI model calls with proper response handling *(Complete after Level 20)*
- [ ] **Input Validation**: Professional error handling and user feedback. Use if statements for this *(Complete after Level 12)*
- [ ] **Challenge: Error Handling**: Graceful handling of API failures and network issues *(Complete after Level 16 for API errors, Level 21 for AI errors)*

### Technical Implementation
- [ ] **Code Organization**: Clean, well-structured JavaScript with meaningful names for ids, variables, and functions
- [ ] **Version Control**: Regular commits with descriptive messages
- [ ] **Testing**: Thoroughly tested across different scenarios and edge cases
- [ ] **Documentation**: Complete README, from the [EXAMPLE_README.md](/codex-lv2-may-2025/guides/week8-capstone/EXAMPLE_README.html) with feature descriptions and checkmarks checked
- [ ] **Polish**: Professional presentation with attention to user experience

---

## 📚 References & Resources  
- [MDN: Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)  
- [MDN: Working with Objects](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/Basics)  
- [Bootstrap Docs](https://getbootstrap.com/docs/5.3/getting-started/introduction/)  
- [Hugging Face Models](https://huggingface.co/models) - Filter by "text generation" and "fireworks"
- [OpenWeatherMap API](https://openweathermap.org/api) - Weather data
- [PokéAPI](https://pokeapi.co) - Pokemon data
- [Events Birds Eye View PDF](/codex-lv2-may-2025/resources/skill-guides/events-birds-eye-view.pdf) - JavaScript event handling

---

## 🙌 Acknowledgements  
List any people, resources, or APIs you used while working on this project.