Skip to content

raz08/todo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸͺ„ AI-Powered To-Do App

A modern, intelligent task management application that combines traditional to-do functionality with AI-powered task planning capabilities.

To-Do App Screenshot HTML5 CSS3 JavaScript Azure AI

✨ Features

πŸ“ Core Task Management

  • Add Main Tasks - Create primary tasks with a simple, intuitive interface
  • Subtask Support - Break down main tasks into smaller, manageable subtasks
  • Inline Editing - Edit task and subtask titles directly by clicking on them
  • Completion Tracking - Mark tasks and subtasks as complete with checkboxes
  • Smart Completion Logic - Automatically handle parent-child task completion relationships
  • Task Deletion - Remove unwanted tasks and subtasks with confirmation dialogs
  • Persistent Storage - All data is automatically saved and survives browser restarts

πŸ€– AI-Powered Features

  • "Plan for Me" - AI-generated subtasks for any main task
  • Azure AI Integration - Powered by Azure AI Foundry models
  • Intelligent Task Breakdown - Converts high-level tasks into actionable steps
  • Smart Suggestions - AI provides 3-8 relevant subtasks per main task

βš™οΈ Configuration & Settings

  • Settings Panel - Easy-to-use configuration interface
  • API Key Management - Secure storage of Azure AI credentials
  • Connection Testing - Verify AI setup before use
  • Customizable Model Selection - Choose your preferred AI model

🎨 User Experience

  • Modern Design - Clean, gradient-based UI with smooth animations
  • Responsive Layout - Works perfectly on desktop and mobile devices
  • Intuitive Controls - Clear visual hierarchy and user-friendly interactions
  • Real-time Updates - Instant feedback and state management
  • Accessibility - Keyboard navigation and screen reader support

πŸš€ Getting Started

Prerequisites

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • Azure AI Foundry account (for AI features)
  • API key and endpoint from Azure AI Foundry

Installation

  1. Clone the repository

    git clone https://github.com/raz08/todo.git
    cd todo
  2. Open the application

    # Simply open index.html in your web browser
    # Or serve it using a local server:
    python -m http.server 8000
    # Then visit: http://localhost:8000
  3. Configure AI Features (Optional)

    • Click the "βš™οΈ Settings" button in the top-right corner
    • Enter your Azure AI endpoint URL
    • Add your API key
    • Specify your model name (e.g., "gpt-4")
    • Test the connection and save

πŸ“– Usage Guide

Basic Task Management

  1. Adding Tasks

    • Type your task in the input field at the top
    • Press Enter or click "Add Task"
  2. Managing Subtasks

    • Click the "+ Sub" button next to any main task
    • Enter subtask details and press Enter or click "Add"
  3. Editing Tasks

    • Click on any task or subtask text to edit it inline
    • Press Enter to save changes
  4. Completing Tasks

    • Check the box next to any task to mark it complete
    • Completing a main task marks all subtasks as complete
    • Completing all subtasks automatically marks the main task as complete

AI-Powered Planning

  1. Setup (First Time)

    • Configure your Azure AI settings in the Settings panel
    • Test the connection to ensure everything works
  2. Using "Plan for Me"

    • Click the purple "πŸͺ„ PlanForMe" button next to any main task
    • Wait for AI to generate relevant subtasks
    • Review and edit the generated subtasks as needed

πŸ—οΈ Technical Architecture

File Structure

todo/
β”œβ”€β”€ index.html          # Main HTML structure
β”œβ”€β”€ style.css           # Styling and responsive design
β”œβ”€β”€ script.js           # JavaScript functionality
└── README.md           # Project documentation

Key Components

HTML (index.html)

  • Semantic HTML5 structure
  • Settings modal for AI configuration
  • Accessible form elements and controls

CSS (style.css)

  • Modern gradient-based design
  • Flexbox and Grid layouts for responsiveness
  • Smooth animations and transitions
  • Mobile-first responsive design

JavaScript (script.js)

  • ES6+ class-based architecture
  • Local storage for data persistence
  • Azure AI API integration
  • Event-driven user interactions

Data Storage

  • Local Storage: Tasks, settings, and user preferences
  • Secure Credential Storage: API keys stored locally with basic security measures
  • Auto-save: All changes are immediately persisted

πŸ”§ Configuration

Azure AI Setup

  1. Get Azure AI Credentials

    • Sign up for Azure AI Foundry
    • Create a new deployment
    • Note your endpoint URL and API key
  2. Configure the App

    Endpoint: https://your-endpoint.cognitiveservices.azure.com
    API Key: your-api-key-here
    Model: gpt-4 (or your preferred model)
    
  3. Test Connection

    • Use the built-in connection test feature
    • Verify successful API communication

🎯 API Integration

The app integrates with Azure AI Foundry using the OpenAI-compatible REST API:

// Example API call structure
POST /openai/deployments/{model}/chat/completions
Headers:
  - Content-Type: application/json
  - api-key: {your-api-key}
Body:
  - messages: [{"role": "user", "content": "task description"}]
  - max_tokens: 500
  - temperature: 0.7

πŸ”’ Security Features

  • API Key Protection: Credentials stored in browser's local storage
  • Input Sanitization: All user inputs are properly escaped
  • Error Handling: Graceful handling of API failures
  • No Server Storage: All data remains on the user's device

🌟 Advanced Features

Smart Task Relationships

  • Parent-child task completion logic
  • Automatic status updates based on subtask completion
  • Intelligent task dependency management

AI Integration

  • Context-aware subtask generation
  • Natural language processing for task breakdown
  • Fallback parsing for various AI response formats

User Experience Enhancements

  • Loading states and progress indicators
  • Confirmation dialogs for destructive actions
  • Keyboard shortcuts and accessibility features

πŸ› οΈ Development

Local Development

# No build process required - pure HTML/CSS/JS
# Simply edit files and refresh the browser

# For local server (recommended):
python -m http.server 8000
# or
npx serve .
# or
php -S localhost:8000

Code Style

  • ES6+ JavaScript with modern syntax
  • Semantic HTML5 elements
  • CSS custom properties for theming
  • Mobile-first responsive design

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“ License

This project is open source and available under the MIT License.

πŸ‘¨β€πŸ’» Author

raz08

πŸ™ Acknowledgments

  • Azure AI Foundry for AI capabilities
  • Modern web standards for clean, accessible design
  • The open-source community for inspiration and best practices

πŸ“š Additional Resources


Made with ❀️ and πŸ€– by raz08

Transform your productivity with AI-powered task planning!

About

To Do app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published