{"id":19739932,"url":"https://github.com/sudo-arash/flask-todo","last_synced_at":"2026-04-09T21:09:07.409Z","repository":{"id":254707670,"uuid":"847319961","full_name":"sudo-arash/flask-todo","owner":"sudo-arash","description":"A simple, yet powerful TODO list application using Flask and HTMX that features many things!","archived":false,"fork":false,"pushed_at":"2024-08-25T13:47:43.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T06:00:14.269Z","etag":null,"topics":["flask","flask-application","flask-authentication","htmx","python","todo-list","web-development"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sudo-arash.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-25T13:44:56.000Z","updated_at":"2024-08-25T13:50:03.000Z","dependencies_parsed_at":"2024-08-25T15:01:57.627Z","dependency_job_id":"99eaf47c-89a6-4e9c-a4a2-0a346fb63a0c","html_url":"https://github.com/sudo-arash/flask-todo","commit_stats":null,"previous_names":["sudo-arash/flask-todo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sudo-arash/flask-todo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-arash%2Fflask-todo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-arash%2Fflask-todo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-arash%2Fflask-todo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-arash%2Fflask-todo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudo-arash","download_url":"https://codeload.github.com/sudo-arash/flask-todo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-arash%2Fflask-todo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260083862,"owners_count":22956409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","flask-application","flask-authentication","htmx","python","todo-list","web-development"],"created_at":"2024-11-12T01:18:51.229Z","updated_at":"2026-04-09T21:09:07.369Z","avatar_url":"https://github.com/sudo-arash.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📝 Flask TODO\n\nWelcome to Flask TODO! 🚀 A simple, yet powerful TODO list application using Flask and HTMX that features user authentication, TODO creation and management, and a host of other interactive interface features.\n\n## 🛠️ Features\n\n### 🔒 User Authentication\n- **Register**: Create a new account with just your full name. You will receive a **unique 16-character key** to use for logging in. 🔑\n- **Login**: Access your TODO list effortlessly with your unique key—no email or password needed! ✨\n### ✅ TODO Management\n- **Add TODOs**: Quickly add new tasks to your list. 🆕\n- **Toggle Completion**: Mark TODOs as completed or incomplete with a single click. ✔️❌\n- **Delete TODOs**: Remove tasks from your list easily. 🗑️\n\n### 🌟 Dynamic Updates\n- **Real-Time Updates**: Thanks to HTMX, the TODO list updates dynamically without refreshing the page. 🖥️🔄\n\n\u003e [!NOTE]\n\u003e There is a small issue and because of that, we need to refresh the page everytime you make a new task. We will be happy to see someone who can fix it! (Read [contributing](#-contributing).)\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Python 3.x\n- Flask\n- Flask-SQLAlchemy\n- Flask-Login\n- Python-dotenv (for environment variables)\n\n### Installation\n\n1. **Clone the repository:**\n    ```bash\n    git clone https://github.com/sudo-arash/flask-todo.git\n    cd flask-todo\n    ```\n\n2. **Create a virtual environment:**\n    ```bash\n    python -m venv venv\n    ```\n\n3. **Activate the virtual environment:**\n    - On Windows:\n      ```bash\n      venv\\Scripts\\activate\n      ```\n    - On macOS/Linux:\n      ```bash\n      source venv/bin/activate\n      ```\n\n4. **Install dependencies:**\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n5. **Set up the environment variables:**\n    - Copy `.env.example` to `.env`:\n      ```bash\n      cp .env.example .env\n      ```\n    - Update `.env` with your own values.\n\n6. **Initialize the database:**\n    ```bash\n    python\n    \u003e\u003e\u003e from app import db\n    \u003e\u003e\u003e db.create_all()\n    ```\n\n7. **Run the application:**\n    ```bash\n    python app.py\n    ```\n    All that remains now is to open `http://127.0.0.1:5000/` in the web browser of your choice, and voilà! You now have your shiny, new todo application up and running.\n\n## 🤝 Contributing\n\nIssues and PRs welcome! Also, feel free to open issues or submit pull requests. 🎉\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo-arash%2Fflask-todo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudo-arash%2Fflask-todo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo-arash%2Fflask-todo/lists"}