diff --git a/README.md b/README.md
new file mode 100644
index 0000000..722a914
--- /dev/null
+++ b/README.md
@@ -0,0 +1,139 @@
+# Fabled Assistant
+
+A self-hosted note-taking and task-tracking application with integrated LLM capabilities. Write, organize, and enhance your notes with the help of a local AI assistant — all running on your own hardware.
+
+## What It Does
+
+**Notes with inline formatting** — Write in Markdown with a live-preview editor. Headings, bold, italic, lists, and code blocks render inline as you type, similar to Obsidian or Typora.
+
+**Task tracking** — Any note can become a task with a status (todo, in progress, done), priority level, and due date. Convert freely between notes and tasks without losing content.
+
+**Wikilinks and backlinks** — Link notes together with `[[Title]]` syntax. Click a wikilink to navigate to (or auto-create) the referenced note. Each note shows what links to it.
+
+**Tag organization** — Add `#tags` anywhere in your text. Tags are extracted automatically and support hierarchical filtering (e.g., `#project/webapp` matches both `project` and `project/webapp`). Tag autocomplete suggests existing tags as you type.
+
+**AI writing assistant** — Select a section of your note and give the assistant an instruction ("summarize this", "make it more concise", "add examples"). The assistant streams a suggestion that you can accept or reject. Powered by Ollama running locally.
+
+**AI chat** — Have conversations with your AI assistant. The chat is context-aware: it can automatically find and reference your notes to give more relevant answers. Attach specific notes for focused discussions. Save useful responses as new notes.
+
+**Multi-user support** — Multiple users can share the same instance with isolated data. The first registered user becomes the admin.
+
+**Dark and light themes** — Defaults to dark mode with a one-click toggle. All views respect your preference.
+
+## Getting Started
+
+### Prerequisites
+
+- [Docker](https://docs.docker.com/get-docker/) and Docker Compose
+- A machine with enough resources to run an LLM (8GB+ RAM recommended for smaller models)
+
+### Quick Start
+
+1. Clone the repository:
+ ```bash
+ git clone https://github.com/your-username/fabledassistant.git
+ cd fabledassistant
+ ```
+
+2. Start the application:
+ ```bash
+ docker compose up --build
+ ```
+
+3. Open `http://localhost:5000` in your browser.
+
+4. Register the first user account (this account becomes the admin).
+
+5. Go to **Settings** to download an LLM model. Smaller models like `llama3.2` (2GB) work well for getting started.
+
+### Day-to-Day Usage
+
+- **Create a note** from the Notes page. Use Markdown — formatting renders live in the editor.
+- **Link notes** by typing `[[` to get a wikilink autocomplete dropdown.
+- **Tag your notes** by typing `#` followed by a tag name. Autocomplete suggests existing tags.
+- **Use the AI assistant** in the bottom panel of the editor. Select a section, write an instruction, and click Generate.
+- **Chat with the AI** from the Chat page. Attach notes for context or let the assistant find relevant notes automatically.
+- **Convert notes to tasks** from the note viewer to add status, priority, and due dates.
+- **Save chat responses** as notes to preserve useful AI-generated content.
+- **Backup your data** from Settings (admin users can export and restore full backups).
+
+## Configuration
+
+Configuration is done via environment variables. See `docker-compose.yml` for defaults.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DATABASE_URL` | `postgresql+asyncpg://...` | PostgreSQL connection string |
+| `SECRET_KEY` | (required) | Session signing key |
+| `OLLAMA_BASE_URL` | `http://ollama:11434` | Ollama API endpoint |
+| `DEFAULT_MODEL` | `llama3.1` | Default LLM model to auto-pull on startup |
+| `LOG_LEVEL` | `INFO` | Logging level |
+
+For production deployments, `docker-compose.prod.yml` supports Docker secrets (`SECRET_KEY_FILE`, `DATABASE_URL_FILE`) and includes network isolation, health checks, and resource limits.
+
+## Technical Overview
+
+### Stack
+
+| Layer | Technology |
+|-------|------------|
+| Frontend | Vue 3, TypeScript, Vite, Pinia, Vue Router |
+| Editor | Tiptap (ProseMirror) with custom extensions |
+| Backend | Python 3.12, Quart (async Flask-like framework) |
+| Database | PostgreSQL 16, SQLAlchemy 2.0 (async), Alembic migrations |
+| LLM | Ollama (or any OpenAI-compatible API) |
+| Deployment | Docker Compose (app + PostgreSQL + Ollama) |
+
+### Architecture
+
+The application runs as a single container serving both the Vue.js SPA and the REST API. The frontend is built by Vite during the Docker image build and served as static files by Quart. API routes live under `/api/`.
+
+LLM interactions use Server-Sent Events (SSE) for streaming responses. Chat generation runs in background `asyncio` tasks with an in-memory event buffer that supports client reconnection without data loss.
+
+The editor uses a Markdown-to-HTML-to-Markdown round-trip: content is stored as Markdown, converted to HTML for Tiptap editing, and serialized back to Markdown on every change. ProseMirror decoration plugins provide visual highlighting for tags and wikilinks without custom node types.
+
+### Database
+
+All data is stored in PostgreSQL. The schema uses a unified model where tasks are notes with additional attributes (`status`, `priority`, `due_date`). Migrations are idempotent raw SQL and run automatically on container startup.
+
+### Project Structure
+
+```
+fabledassistant/
+├── docker-compose.yml # Development stack
+├── docker-compose.prod.yml # Production stack (Docker Swarm)
+├── Dockerfile # Multi-stage build (Node + Python)
+├── alembic/ # Database migrations
+├── src/fabledassistant/ # Python backend
+│ ├── app.py # Quart app factory
+│ ├── models/ # SQLAlchemy models
+│ ├── routes/ # API route blueprints
+│ ├── services/ # Business logic
+│ └── static/ # Built frontend (generated)
+└── frontend/ # Vue.js frontend
+ └── src/
+ ├── views/ # Page components
+ ├── components/ # Reusable UI components
+ ├── extensions/ # Tiptap/ProseMirror plugins
+ ├── composables/ # Vue composables
+ ├── stores/ # Pinia state management
+ └── api/ # API client
+```
+
+### Development
+
+All development is done via Docker:
+
+```bash
+# Start the dev stack
+docker compose up --build
+
+# Reset database (destroy volumes and rebuild)
+docker compose down -v && docker compose up --build
+```
+
+No local dependency installation required.
+
+## License
+
+This project is privately maintained.
diff --git a/frontend/package.json b/frontend/package.json
index a40e271..34f3a94 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -9,6 +9,12 @@
"preview": "vite preview"
},
"dependencies": {
+ "@tiptap/extension-link": "^2.11.0",
+ "@tiptap/extension-placeholder": "^2.11.0",
+ "@tiptap/pm": "^2.11.0",
+ "@tiptap/starter-kit": "^2.11.0",
+ "@tiptap/suggestion": "^2.11.0",
+ "@tiptap/vue-3": "^2.11.0",
"pinia": "^2.2.0",
"vue": "^3.5.0",
"marked": "^15.0.0",
diff --git a/frontend/src/App.vue b/frontend/src/App.vue
index 119497b..80d99b1 100644
--- a/frontend/src/App.vue
+++ b/frontend/src/App.vue
@@ -1,8 +1,6 @@
@@ -21,9 +81,9 @@ const buttons = [
@@ -50,4 +110,9 @@ const buttons = [
.md-btn:hover {
background: var(--color-bg-secondary);
}
+.md-btn.active {
+ background: var(--color-primary);
+ color: #fff;
+ border-color: var(--color-primary);
+}
diff --git a/frontend/src/components/SuggestionDropdown.vue b/frontend/src/components/SuggestionDropdown.vue
new file mode 100644
index 0000000..bb00933
--- /dev/null
+++ b/frontend/src/components/SuggestionDropdown.vue
@@ -0,0 +1,90 @@
+
+
+
+