Skip to content

Latest commit

 

History

79 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Puffnotes Banner

puffnotes

A cozy place for messy notes. ☁️

AI Powered Google Drive Sync Offline Ready MIT License


What is puffnotes?

Puffnotes is a small Markdown editor for getting thoughts down before they disappear. Write the rough version first, then let AI clean up the structure when you want it to.

Dump the messy thoughts. Make them readable with one click.

You can use it online with Google Drive sync or keep everything in a local folder. Both modes have the same editor, themes, Markdown preview, focus mode, and PDF export.


✍️ Choose how you write

Pick the mode that makes sense for the note:

☁️ Online mode

For notes you want everywhere

  • Syncs notes with Google Drive
  • Works across your signed-in devices
  • Uses Google authentication
  • Keeps the full Puffnotes editor and AI tools

💻 Offline mode

For notes you want on your computer

  • Saves straight to a folder you choose
  • No account or sign-up
  • Nothing is uploaded for storage
  • Works in Chromium browsers with folder access

What it does

AI cleanup ✨

Write the bad first draft. Puffnotes can turn it into a clearer, structured Markdown note without making you organize every thought as it arrives.

2.mp4

Markdown and live preview

Write in Markdown, then switch to Preview whenever you want to see the formatted note.

3.mp4

Focus mode

Tuck the editor controls away and leave the note on screen. Useful when the buttons start feeling louder than the words.

5.mp4

PDF export

Export a note as a styled PDF. Markdown formatting, page breaks, and the selected Puffnotes theme carry into the file.

4.mp4

Bring your own Groq key

The shared AI key has daily limits. You can add a free Groq API key in Settings if you want your own allowance. Puffnotes keeps it in your browser and sends requests directly to Groq.

6.mp4

Who is it for?

Students Writers Developers 2 AM thinkers
Clean up lecture notes Get the rough idea out first Keep Markdown-native notes Catch a thought before it leaves
Organize study material Write without a crowded interface Choose local files or Drive Fix the structure tomorrow

🚀 Getting started

🌐 Open Puffnotes and choose Online or Offline.

📝 Start typing. Use the ✨ button when the note needs cleaning up. Autosave handles the rest. 💾

No tutorial required. It is a notes app. You know what to do.


Roadmap

Puffnotes is still growing, but I would rather add useful things slowly than turn it into a dashboard with seventeen sidebars.

Feature Status
✨ AI note cleanup ✅ Complete
📄 PDF export ✅ Complete
☁️ Google Drive sync ✅ Complete
💾 Offline folder storage ✅ Complete
🎨 Warm, Galaxy, and Komorebi themes ✅ Complete
🪄 Custom AI prompts ⏳ Planning
🖼️ Drag-and-drop images ⏳ Planning
🗂️ Better note organization ⏳ Planning
📱 Mobile companion app ⏳ Planning
🔄 Imports from tools such as Notion and Obsidian ⏳ Planning

Dev team

Just me, actually.

Name Institution ID GitHub Followers
Rajin Khan North South University 2212708042 Rajin's GitHub Followers

I like tools that get out of the way. Puffnotes is my attempt at making one.

⭐ Star the repo if you want to see where it goes.

About

Minimalist note-taking app that turns rough ideas into beautifully structured notes using AI.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages