🌊 DriftNotes – Your Flowing Personal Notebook

A minimalist, book-styled personal notebook built with Streamlit and TinyDB, designed exclusively for dark mode aesthetics.

---

✨ Overview

DriftNotes is not just a note-taking app—it’s your personal, aesthetic vault for thoughts, snippets, and inspirations. With its dark-only themes, glowing typography, and lightweight storage powered by TinyDB, DriftNotes gives you a unique mix of elegance and simplicity. Whether you’re journaling late at night, drafting code snippets, or organizing study notes, this app makes it all feel like writing in a beautifully styled digital diary.

---

🌟 Features

• 🖤 Dark Mode Only – immersive and eye-friendly design.
• 📝 Markdown Support – write in Markdown, preview instantly.
• 📂 Local Storage with TinyDB – your notes stay lightweight and portable.
• 🔍 Search & Tags – quickly find notes using tags or keywords.
• 📑 Note Management – create, edit, delete, and pin notes.
• 🎨 Aesthetic Themes – choose from dark-inspired palettes: Nebula, Ocean, Forest, Noir.
• 📊 Extras – word count, reading time, last modified time.
• 📤 Export Notes – save as Markdown or PDF (powered by ReportLab).
• 🤖 Gemini AI Integration – generate ideas, summaries, or improve notes using Google’s Generative AI.

---

📂 Project Structure

driftnotes/
├── app.py               # Main Streamlit application
├── requirements.txt     # Dependencies
├── README.md            # Project documentation
└── assets/              # Fonts, styles, or images (optional)

---

🚀 Getting Started

1️⃣ Clone the repository

git clone https://github.com/yourusername/driftnotes.git
cd driftnotes

2️⃣ Install dependencies

pip install -r requirements.txt

3️⃣ Run the app

streamlit run app.py

The app will open in your browser 🌙.

---

⚙️ Configuration

Environment Variables

To use Gemini AI features, set your API key:

export GOOGLE_API_KEY="your_api_key_here"

Or create a .env file with:

GOOGLE_API_KEY=your_api_key_here

---

🎨 Design Philosophy

DriftNotes blends dark aesthetics with a minimalist book-like feel:

• Neon glow typography ✨
• Smooth animations for note transitions 📜
• Cozy color palettes 🌌
• Simplicity over clutter 🌿

Every note feels like a page in your private digital grimoire.

---

📖 Usage Examples

• Study Notes → Organize Python, Math, or Engineering concepts.
• Journaling → Daily thoughts or reflections.
• Creative Writing → Poems, short stories, or drafts.
• Coding Snippets → Save commonly used code blocks.

---

📦 Requirements

streamlit
markdown
reportlab
google-generativeai
tinydb

---

🛠️ Future Enhancements

• 🔒 Add password-protected “vault mode.”
• 📅 Calendar integration for daily notes.
• ☁️ Cloud sync option.
• 📎 Attachments (images, PDFs).

---

📜 License

MIT License © 2025

---

💡 Inspiration

"A notebook should feel personal—like drifting into your own world with every word you write."