55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
# Steady
|
|
|
|
Steady is an ADHD-friendly task manager built with Flask. It provides a modular
|
|
application foundation, secure authentication, task and subtask management, a
|
|
seven-item Today view, status filters, priorities, progress indicators, and a
|
|
single-task Focus Mode with countdowns, time blocks, context cues, positive
|
|
completion feedback, forgiving streaks, bulk text capture, and portable JSON
|
|
backups with reversible completed-task clearing.
|
|
|
|
## Local setup
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
python -m pip install -r requirements.txt
|
|
flask --app app run --debug
|
|
```
|
|
|
|
The development server is available at `http://127.0.0.1:5000`. Copy
|
|
`.env.example` to `.env` or export its values in your shell. Replace the sample
|
|
`SECRET_KEY` before using the app beyond local development.
|
|
|
|
## Database migrations
|
|
|
|
Apply the committed migrations after installing dependencies:
|
|
|
|
```bash
|
|
flask --app app db upgrade
|
|
```
|
|
|
|
When a model changes, generate a migration with
|
|
`flask --app app db migrate -m "Describe the schema change"`, review the
|
|
generated operations, and commit them so every environment applies the same
|
|
schema.
|
|
|
|
## Tests
|
|
|
|
```bash
|
|
python -m pytest
|
|
```
|
|
|
|
Tests use an isolated in-memory SQLite database and never write to the local
|
|
development database.
|
|
|
|
## Data and backups
|
|
|
|
After signing in, open `/tasks/transfer` to:
|
|
|
|
- import up to 200 UTF-8 Markdown or plain-text task lines;
|
|
- download a versioned JSON backup without credentials or account identifiers;
|
|
- merge or replace tasks from a validated Steady backup; and
|
|
- clear completed tasks with an immediate user-scoped undo action.
|
|
|
|
JSON restore validates the complete file before changing tasks. Keep downloaded
|
|
backups private because task descriptions may contain personal information.
|