An active knowledge‑management and multi‑modal note‑taking platform for deep thinkers.
Stop collecting. Start reflecting.
Most knowledge‑management tools are glorified bookmarks. You gather articles, highlight text, save links, and then forget everything.
Relatrix changes that. Built on a single, uncompromising philosophy:
Information only becomes knowledge when you engage with it through active reflection.
Every resource you save is a starting point, not a destination. Relatrix provides a multi‑modal toolkit to break down, question, and connect information across diverse formats.
Relatrix is built around a few simple concepts that work together.
| Concept | Description |
|---|---|
| Topic | A collection of related resources and a Topic Overview. |
| Resource | Source material added to a Topic. Supports links, files of any type, and Markdown. |
PDFs: When a PDF is added as a resource, it can be opened directly in the built-in PDF Reader.
| Feature | Description |
|---|---|
| Topic Overview | A dedicated note for each Topic. |
| Resource Overview | A dedicated note for each Resource. |
| Notes Editor | Markdown editor for Topic Overviews, Resource Overviews, and Markdown resources. |
| Feature | Description |
|---|---|
| Tags | Tags attached to individual entries for organizing related ideas. |
| Links | [[wiki-links]] connecting Topics, Resources, Notes, and timeline entries. |
Every resource has a unified timeline of cards to track your reflections and interactions with it.
| Entry Type | Description |
|---|---|
| Opinion | A timestamped personal reflection with a confidence score. |
| Template | Structured forms for guided reflection. |
| Vision | A visual note such as a photo, sketch, or screenshot with an optional caption. |
These entries are specific to PDF resources.
| Entry Type | Description |
|---|---|
| Annotation | A highlight or inline note anchored to a specific text passage. |
| Bookmark | A saved point in the document, with additional reading context. |
| Lookup | A specific phrase or term that was looked up through selected search engine in default browser. |
Relatrix is a live, physics‑simulated 3D graph that renders the connective tissue of your knowledge base. Every node is a resource or topic; every edge is a knowledge link you created. Filter by entry types and explore the relationships between your ideas. Pinch to zoom, drag to rotate, and adjust the physics engine (repulsion, spring tension) in real time.
Relatrix is built for long‑term stability and privacy. The codebase uses Kotlin Multiplatform so that the core business logic is shared across Android and (upcoming) iOS.
Relatrix/
├── shared/ # Platform‑agnostic core
│ ├── domain/ # Models: Topic, Resource, Opinion, Annotation, Bookmark, Template
│ ├── data/ # SQLDelight repositories, encrypted with SQLCipher
│ └── business/ # SearchEngine, AutoLinkService, ExportService
│
└── androidApp/ # Native Android client
├── ui/ # Jetpack Compose screens & components
├── viewmodel/ # MVVM architecture using shared ViewModels
├── di/ # Koin dependency injection modules
└── workers/ # WorkManager background tasks (Cleanup, etc.)
| Layer | Technology |
|---|---|
| Language | Kotlin Multiplatform |
| Android UI | Jetpack Compose |
| iOS UI | SwiftUI (in development) |
| Database | SQLDelight + SQLCipher (encrypted) |
| Concurrency | Kotlin Coroutines & Flow |
| Dependency Injection | Koin |
| Background Work | WorkManager |
| PDF Rendering | Custom paged renderer via PDFBox-Android |
- Android Studio Ladybug or later
- JDK 17+
- Android SDK (API 26+)
# 1. Clone the repo
git clone https://github.com/saad-ibra/relatrix.git
cd relatrix
# 2. Open in Android Studio
# File → Open → select the cloned folder
# 3. Sync Gradle & run
# Select the 'androidApp' configuration and press RunThe database is encrypted with SQLCipher and fully offline — no backend, no account, no tracking.
- Multi‑modal resource entry with confidence scoring
- Unified Timeline (Opinions + Annotations + Bookmarks + Visuals + Templates)
- Relatrix 3D knowledge graph with physics simulation
- SQLCipher‑encrypted offline database
- Full‑text offline search across topics, resources and entries
- PDF reader
- Knowledge links across topics, resources and entries
- Light and Dark mode
- Topic custom colour assignment
- Tags management
- iOS app (SwiftUI) — in development
Built by a sleep-deprived human who read way too many PDFs just to make sure the progress bar felt right
For researchers, deep readers, students, and anyone who actually wants to understand what they consume.