# 🌱 Little Milestones

A daily record plugin for kids — behavior scoring, diary, diet & activity tracking, with structured data ready for AI analysis.

## Features

### 📊 Behavior Scoring
- Customizable scoring categories and items
- Positive and negative scoring system
- Daily and monthly statistics
- Progress tracking over time

### 📝 Diary & Notes
- Rich diary module with multiple field types
- Custom placeholders and templates
- Markdown support
- File attachments

### 🍎 Diet & Activity Tracking
- Food and meal tracking
- Activity and exercise logging
- Custom categories for all tracking needs

### 📈 Reports & Analytics
- Automated report generation
- Data visualization
- Export to YAML for AI analysis
- Structured data format ready for LLM processing

### 📱 Multi-platform Support
- Works seamlessly on desktop and mobile
- Responsive design optimized for all screen sizes
- Touch-friendly interface for mobile devices

## Installation

### From Obsidian Community Plugins
1. Open Obsidian Settings
2. Go to Community Plugins
3. Search for "Little Milestones"
4. Click Install and Enable

### Manual Installation
1. Download the latest release from GitHub
2. Extract the files to your vault's `.obsidian/plugins/little-milestones` folder
3. Enable the plugin in Obsidian settings

## Getting Started

1. **Open the Plugin**: Click the 🌱 icon in the ribbon or use the command "Open Little Milestones"
2. **Configure Settings**: Go to plugin settings to customize:
   - Scoring categories and items
   - Diary modules and fields
   - Goals and targets
   - Report templates
3. **Start Tracking**: Use the daily modal to record behavior, write diary entries, and track activities
4. **View Reports**: Generate reports to see progress and patterns over time

## Core Concepts

### Scoring System
- **Categories**: Group related scoring items (e.g., "Behavior", "Academics", "Health")
- **Items**: Specific behaviors to track (e.g., "Finished homework", "Helped with chores")
- **Scores**: Each item can have positive or negative point values
- **Daily Summary**: See total scores and trends at a glance

### Diary Modules
- **Preset Modules**: Pre-configured diary templates for common use cases
- **Custom Modules**: Create your own diary fields with custom types (text, number, select, etc.)
- **Quick Entry**: Fast data entry with keyboard shortcuts and auto-focus

### Data Structure
All data is stored as YAML frontmatter in daily notes, making it:
- Human-readable
- AI-friendly for analysis
- Compatible with other Obsidian plugins
- Easy to export and backup

## Usage Tips

### Keyboard Shortcuts
- `Ctrl/Cmd + M`: Open the daily scoring modal
- Use arrow keys to navigate between sections
- `Tab` to move between fields

### Best Practices
- Keep scoring items simple and consistent
- Use the diary feature to add context to scores
- Review reports regularly to identify patterns
- Customize categories to match your specific needs

### For AI Analysis
The structured YAML format works great with:
- ChatGPT and other LLMs
- Data analysis tools
- Custom scripts and automation

## Support & Feedback

- **GitHub Issues**: Report bugs or request features
- **Discord**: Join the Obsidian community Discord to discuss
- **Email**: Contact the developer directly

## Contributing

Contributions are welcome! Feel free to:
- Submit pull requests
- Report issues
- Suggest new features
- Improve documentation

## License

MIT License - see LICENSE file for details

---

Made with ❤️ for parents and kids tracking growth together.