https://github.com/rajin-khan/puffnotes
Minimalist note-taking app that turns rough ideas into beautifully structured notes using AI.
https://github.com/rajin-khan/puffnotes
ai cozy fortheloveofcode local markdown minimalist notes pdf
Last synced: 7 months ago
JSON representation
Minimalist note-taking app that turns rough ideas into beautifully structured notes using AI.
- Host: GitHub
- URL: https://github.com/rajin-khan/puffnotes
- Owner: rajin-khan
- Created: 2025-04-07T18:56:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-13T11:20:15.000Z (10 months ago)
- Last Synced: 2025-09-13T13:46:25.617Z (10 months ago)
- Topics: ai, cozy, fortheloveofcode, local, markdown, minimalist, notes, pdf
- Language: JavaScript
- Homepage: https://puff-notes.vercel.app
- Size: 44.9 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README

# puffnotes
### *The coziest way to write notes — even if you barely write at all.*
[](https://groq.com/) [](https://www.google.com/drive/) []()
[]()
---
## 💭 What is puffnotes?
**Puffnotes** transforms the way you capture and refine ideas. It's a beautifully minimal, dual-mode markdown editor that bridges the gap between scattered thoughts and polished content.
> ✨ **Turn messy brain dumps into elegant, structured notes, with a single tap.**
Designed for *creative minds, busy students, and thoughtful writers* who want their tools to be as intuitive as their thinking process. Whether you're online with full sync capabilities or working offline in complete privacy, Puffnotes adapts to your workflow.
---
## 🎯 Choose Your Experience
Puffnotes respects how you work. Pick the mode that fits your needs:
### ☁️ **Online Mode**
*- Seamless & Connected*
- **Auto-syncs** with Google Drive
- Access from **any device, anywhere**
- **Secure Google authentication**
- Perfect for **multi-device workflows**
- **Full feature access**
### 💻 **Offline Mode**
*- Private & Lightning Fast*
- **Complete privacy** - nothing leaves your device
- **Zero latency** - instant everything
- **No accounts** or sign-ups required
- **Local-first** storage
- Works in any **Chromium browser**
---
## ✨ Experience the Magic
### 🪄 **AI-Powered Beautification**
Transform rough ideas into polished prose instantly. Our AI understands context, improves structure, and maintains your unique voice while making everything more readable and professional.
https://github.com/user-attachments/assets/4670cd02-0994-4fdb-afe1-f4c57136e1a4
### 📝 **Effortless Markdown + Live Preview**
Write in clean, intuitive Markdown syntax. Toggle between editing and preview modes to see your beautifully formatted content come to life in real-time.
https://github.com/user-attachments/assets/2fb401fb-c1dd-47a8-b3ab-1f1f00c4d563
### 🧘 **Distraction-Free Focus Mode**
When it's time to think deeply, everything else fades away. Enter a zen-like state where only your words and a calming background remain, helping you achieve true flow.
https://github.com/user-attachments/assets/951a4cff-ff21-4b4b-a9a6-f10277c7ea84
### 📄 **Professional PDF Export**
Share your work with confidence. Export any note as a clean, professionally formatted PDF that preserves all styling and looks great in print or digital form.
https://github.com/user-attachments/assets/87ff217b-17ee-40f7-96e8-a5d7605e3ef0
### 🔑 **Unlimited AI with Your Own Key**
While our shared AI has daily limits, you can unlock unlimited power by adding your own free Groq API key. It's secure, private, and gives you complete control.
https://github.com/user-attachments/assets/78cfc0b5-96cf-47b4-9ce6-c689f98be699
---
## 🎨 Perfect For
| 🎓 **Students** | ✍️ **Writers** | 💻 **Developers** | 🌙 **Night Thinkers** |
|:---:|:---:|:---:|:---:|
| Structure lecture notes effortlessly | Distraction-free writing sanctuary | Markdown-native documentation | Quick thought capture |
| AI helps organize study materials | Expand ideas with intelligent assistance | Flexible online/offline modes | No friction, just flow |
---
## 🏁 Getting Started
**It's beautifully simple:**
**1.** Visit the app → **2.** Pick your mode → **3.** Start writing → **4.** Hit ✨ to beautify → **5.** Autosave handles the rest
*No tutorials needed. No complexity. Just pure, magical simplicity.*
---
## 🔮 Roadmap
The journey toward the perfect thinking tool:
| Feature | Status |
|--------------------------------------------------------------------------------------------|-------------|
| ✅ AI-powered content enhancement | Completed |
| ✅ Professional PDF export | Completed |
| ✅ Google Drive synchronization | Completed |
| ✅ Offline-first architecture | Completed |
| ⏳ Beautiful themes | In Progress |
| ⏳ Custom AI prompts | Planning |
| ⏳ Drag-and-drop images | Planning |
| ⏳ Smart organization | Planning |
| ⏳ Mobile companion app | Planning |
| ⏳ Integration ecosystem with your favorite tools (Import from Notion, Obsidian, and more) | Planning |
---
## **👨💻 Dev Team**
Just me, actually.
| Name | Institution | ID | GitHub | Followers |
|---------------------------|-------------------------|-- |--------|------|
| **Rajin Khan** | North South University | 2212708042 | [](https://github.com/rajin-khan) |  |
---
I believe that **good tools disappear**. They don't demand attention or force you into rigid workflows. Instead, they amplify your natural thinking process, making you more creative and productive without getting in the way.
That's what puffnotes is meant to be.
### ⭐ **Star this repo if you want more cool stuff like this!**
---