# Notiforge

> Notiforge is an AI-powered personal knowledge management (PKM), Zettelkasten knowledge graph, spaced repetition (SRS), and intelligent task management platform available on Web and Android.

## Overview

Notiforge combines block-based note-taking, semantic knowledge graph visualization, spaced repetition flashcard learning (SuperMemo SM-2 algorithm), and multimodal AI assistance (text, vision, audio transcription) into a unified digital garden.

- **Website**: https://notiforge.com
- **Web App / Login**: https://notiforge.com/login
- **Interactive Knowledge Graph**: https://notiforge.com/graph
- **Platforms**: Web (Single Page App / PWA), Android (Jetpack Compose Native App)
- **Primary Languages Supported**: Turkish, English

---

## Core Capabilities & Features

### 1. Block-Based Note-Taking & Zettelkasten Knowledge Graph
- **Atomic Blocks**: Create and organize ideas using flexible atomic blocks (Text, Code, Lists, Callouts, Quizzes, Flashcards).
- **Knowledge Graph (Zihin Ağı)**: Interactive 2D/3D network visualization that maps connections between notes and concepts using semantic embeddings and explicit references.
- **Bidirectional Links**: Effortlessly link related thoughts and explore emerging topics in your knowledge graph.

### 2. Spaced Repetition System (SRS) & Vocabulary Learning
- **SuperMemo SM-2 Algorithm**: Calculate optimal review intervals to transfer learned words, definitions, and concepts into long-term memory.
- **Interactive Flashcards**: Card flip, reverse mode, and active recall testing.
- **Audio & Pronunciation**: Built-in text-to-speech (TTS) for language acquisition and vocabulary mastery.

### 3. Multimodal AI Assistant (Notiforge AI)
- **Note Summarization & Synthesis**: Automatically generate executive summaries, key takeaways, and study notes.
- **Quiz & Test Generator**: Produce multiple-choice and open-ended review questions directly from your notes.
- **Voice & Audio Transcription**: Transcribe voice memos and lecture recordings into structured notes using OpenAI Whisper.
- **Vision & Document Analysis**: Extract handwritten notes, diagrams, and text from uploaded photos using Gemini multimodal vision models.

### 4. Smart Task Management & Google Calendar Sync
- **AI Task Extraction**: Automatically identify action items and deadlines within notes.
- **Bidirectional Google Calendar Sync**: Synchronize tasks, due dates, and reminders with Google Calendar in real-time.

---

## Technology Stack

- **Frontend (Web)**: Modern Vanilla JavaScript SPA, Vis.js (Network Graph), CSS Custom Properties, Service Workers / PWA.
- **Mobile (Android)**: Kotlin, Jetpack Compose, Clean Architecture + MVI/MVVM, Room Database, Retrofit.
- **Backend**: Node.js, Express 5, Socket.IO (Real-time updates), MySQL, Firebase Authentication & Admin SDK.
- **AI Services & Workers**: Google Gemini Models (2.5 / Pro), OpenAI Whisper, FastEmbed / Vector Embeddings.

---

## Key URLs for Crawlers and Agents

- [Home & App](https://notiforge.com/): Primary dashboard and note workspace.
- [Login & Showcase](https://notiforge.com/login): Authentication and platform feature showcase.
- [Knowledge Graph Explorer](https://notiforge.com/graph): Standalone full-screen knowledge graph explorer.
- [Sitemap](https://notiforge.com/sitemap.xml): Search engine sitemap.
- [Robots.txt](https://notiforge.com/robots.txt): Crawler rules and directives.