docs: update README

Author: dnlzrgz

README.md

@@ -1,3 +1,79 @@
 # memotica
 
-An easy, fast, and minimalist space repition application for the terminal
+An easy, fast, and minimalist space repetition application for the terminal
+
+![Main screen screenshot](./assets/memotica_tui.svg)
+
+## Features
+
+- Markdown support for flashcards.
+- Advanced spaced repetition with the SM2 algorithm.
+- Keyboard-First navigation.
+- Easy to add, edit and delete decks and flashcards.
+
+## WIP
+
+memotica is nearly ready for use, but I there are some features that I would like to implement before reaching version `v1.0.0`:
+
+- Customizable space repetition algorithm.
+- Import command.
+- Interoperability with Anki.
+- Sub-decks support.
+- Better flashcards management.
+- Basic statistics.
+- Visual indicators.
+
+## Motivation
+
+Recently, I began to study German and a bit of Japanese. At the same time I was also playing with the idea of playing a bit more with [textual](https://textual.textualize.io/). After encountering some issues with the Anki application on Linux, I decided that it would be a great idea to create a similar application more tailored for my needs and usage.
+
+## Screenshots
+
+![Help modal](./assets/memotica_help.svg)
+![Review Screen](./assets/memotica_review_answer.svg)
+
+## Installation
+
+> memotica automatically creates a directory in the most appropriate location based on your operating system. This directory contains a SQLite database where all your decks and flashcards are stored. You can learn more about how this is done [here](https://click.palletsprojects.com/en/8.1.x/api/#click.get_app_dir).
+
+### Using `pip`
+
+```bash
+pip install memotica
+```
+
+### With `pipx` (recommended)
+
+```bash
+pipx install memotica
+```
+
+## Usage
+
+Once memotica is installed, you should have the `memotica` command available. To start the TUI simply run:
+
+```bash
+memotica
+```
+
+Or, if you want to see the help message and other available commands, run:
+
+```bash
+memotica --help
+```
+
+Once the TUI is displayed, you can:
+
+- **Display the help message** by pressing `F1`.
+- **Add a new deck** by pressing `ctrl +  n`.
+- **Add flashcards** with `ctrl+a`.
+
+After you've added flashcards, select a deck in the deck tree and press `ctrl+s` to begin the review process.
+
+## Help is Welcome
+
+If you have any suggestions or would like to contribute to this project, please feel free to open an issue. Thank for your interest!
+
+## Thanks
+
+I took inspiration and implement various aspects of memotica by reviewing and studying the source code from [harlequin.sh](https://harlequin.sh/).

assets/memotica_add_flashcard.svg

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "memotica"
-version = "0.3.4"
+version = "0.3.5"
 description = "An easy, fast, and minimalist space repition application for the terminal."
 authors = ["dnlzrgz <24715931+dnlzrgz@users.noreply.github.com>"]
 license = "MIT"

assets/memotica_help.svg

@@ -1,18 +1,23 @@
+from datetime import datetime
 import os
 import zipfile
-from datetime import datetime
 import click
 import pandas as pd
 from sqlalchemy import create_engine
 from sqlalchemy.orm import Session
+from memotica.config import Config
 from memotica.db import init_db
 from memotica.tui import MemoticaApp
-from memotica.config import Config
 
 
 @click.group(invoke_without_command=True)
 @click.pass_context
 def cli(ctx) -> None:
+    """
+    memotica is an easy, fast and minimalist application for your terminal that allows you
+    to learn using space repetition.
+    """
+
     ctx.ensure_object(dict)
 
     config = Config()
@@ -47,10 +52,15 @@ def run(ctx):
         file_okay=False,
         dir_okay=True,
     ),
+    help="Path to the directory where the export file will be saved. Defaults to the current directory.",
 )
 def export(ctx, path):
     """
     Exports your memotica data.
+
+    This command exports your memotica data (decks, flashcards, and reviews) into
+    a ZIP file containing a CSV for each table. The ZIP file is saved in the
+    specified directory.
     """
 
     engine = ctx.obj["engine"]