README.md

Flask HTMX Task Manager

A dynamic task management application built with Flask and HTMX that helps prioritize and manage tasks based on urgency and importance.

Features

• Quick task capture with minimal friction
• Dynamic priority scoring based on:
  • Urgency (1-5)
  • Importance (1-5)
  • Deferral penalties
• Real-time UI updates using HTMX
• Task actions:
  • Complete tasks
  • Defer tasks
  • Escalate priority
  • Adjust urgency/importance
  • Delete tasks

Installation

1. Clone the repository:

git clone https://github.com/yourusername/task-manager-flask-htmx.git
cd task-manager-flask-htmx

2. Create a virtual environment and activate it:

python -m venv venv
.\venv\Scripts\activate

3. Install dependencies:

pip install flask flask-sqlalchemy

Running the Application

1. Initialize the database:

python app.py

2. Access the application at http://localhost:5000

Tech Stack

• Flask - Web framework
• SQLAlchemy - Database ORM
• HTMX - Dynamic UI updates
• SQLite - Database

Project Structure

task-manager-flask-htmx/
│
├── app.py              # Main application file
├── templates/          # HTML templates
│   ├── index.html     # Main page template
│   ├── _task_row.html # Task row partial
│   └── ...
│
└── static/            # Static assets
    ├── css/          # Stylesheets
    └── js/           # JavaScript files

Contributing

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

License

This project is licensed under the MIT License - see the LICENSE file for details.