**Muhammad Talha Yaseen** · Full Stack Developer --- > **The name "Mantiq" (Logic)** is inspired by the great Arab Muslim scholars who were masters of logic and knowledge. Just as they carefully recorded and shared wisdom, this app is a modern tool for your thoughts, powered by Artificial Intelligence. ## 📖 About The Project **Mantiq** is a full-stack note-taking app that does more than just save text. It bridges the gap between a simple notebook and a smart workspace. I built this project to demonstrate advanced skills in the **MERN Stack** (MongoDB, Express, React, Node.js). It goes beyond the basics to include **Real-Time Collaboration** and **Generative AI**, creating a place where you can write freely and get help instantly. --- ## 🌟 Why This App? We believe in a **User-First** approach. While building this app, we focused heavily on User Experience (UX) to ensure your data is safe and your experience is seamless. - **Safety Net:** Accidental deletion happens. That's why we included a **Trash** system with a recovery timer. - **Freedom:** You can export your data anytime in multiple formats. - **Privacy:** You can deactivate your account if you need a break, with a grace period to change your mind. --- ## ✨ Features This application comes packed with essential tools and powerful modern features. ### ✅ Core Features - **🔐 Secure Login:** Sign Up and Login easily using **Google** or **GitHub**. Your notes are private and secure using industry-standard authentication. - **📝 Note Management:** Full control over your notes. Write beautifully with headings, lists, bold text, code blocks, and more using a notion-style editor. - **❤️ Favorites & Pins:** Mark your most loved notes as **Favorite** to find them quickly. **Pin** important notes to the top of your dashboard. - **🤝 Smart Sharing & Collaboration:** Generate a unique link to share your note. You decide who makes changes with distinct access levels like **Read-Only** or **Edit**. - **📊 Activity Logging:** Important events are logged to ensure a stable experience. - **🛡️ Error Handling:** Helpful messages instead of crashing, keeping you in control. - **🧪 Reliable Testing:** Code is tested automatically using **Vitest**. - **🔍 Code Quality:** Checked by **SonarQube** to ensure clean, maintainable code. - **🗄️ Smart Database:** Organized storage for Users, Notes, and Shared Sessions using **MongoDB**, designed for scale. --- ### 🚀 Advanced Features (The "Mantiq" Edge) - **🤖 AI Assistant (Gemini):** Stuck on a sentence? Ask the AI to **write for you**, **summarize notes**, **fix grammar**, or **give you ideas** right inside the editor. - **🤝 Real-Time Collaboration:** Work together! Multiple users can edit the same note at the same time. We use **Socket.io** and **CRDTs (Yjs)** to merge changes intelligently. - **📤 Export Options:** Download your notes in PDF, Markdown (.md), HTML, or DOCX formats. - **🗑️ Trash & Recovery:** Deleted notes move to the **Trash**. You have **30 Days** to restore them. - **🚦 Account Management:** Deactivate your account and reactivate it simply by logging in within 30 days. --- ## 🛠️ Tech Stack ### Frontend (Client-Side) - **React.js (v18+) & TypeScript** - **Vite** for fast builds - **Tailwind CSS & Shadcn UI** for modern design - **Zustand** for state management - **BlockNote** for notion-style rich text editing - **React Query** for data synchronization ### Backend (Server-Side) - **Node.js & Express** - **MongoDB & Mongoose** - **Socket.io & Yjs (CRDT)** for real-time collaboration - **Google Gemini AI** for intelligent features - **Auth.js** for authentication - **Pino** for structured logging ### Quality Assurance - **Vitest** for unit testing - **SonarQube** for code quality inspection --- ## 📸 Images

--- ## 🧪 Testing & Code Quality Rigorous testing with **Vitest** and continuous inspection using **SonarQube**.