Skip to content

sammmiksha/notebloom

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

7 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒธ NoteBloom โ€” Cute Study Notebook Widget

A beautifully designed, installable Progressive Web App for students to take notes, paste screenshots, and stay organized during online lectures and meetings.

Live Demo PWA License


๐Ÿ“ธ Screenshots

Dashboard Wide Editor Wide
Editor Narrow View Dashboard Narrow View
> **Tip:** The app adapts its layout depending on window size โ€” snap it beside your lecture video for a distraction-free note-taking experience!

โœจ What is NoteBloom?

NoteBloom is a lightweight, offline-capable note-taking app built specifically for students. Whether you're in a Zoom lecture, watching a recorded session, or sitting in a live class โ€” NoteBloom keeps your notes organized in one cute, distraction-free space.

You can:

  • Create multiple notebooks for different subjects or courses
  • Write notes with rich text formatting (bold, italic, underline)
  • Paste screenshots directly from your clipboard into your notes
  • Choose between page styles (Blank, Ruled, Grid, Dot Grid) to match how you think
  • Switch between multiple themes to personalize your workspace
  • Work completely offline โ€” no internet needed after install
  • Install it like a native app on Windows, Mac, Android, or iOS via Chrome

๐Ÿš€ Getting Started

Option 1: Use in Browser (No Install)

  1. Visit https://sammmiksha.github.io/notebloom/
  2. Start using it immediately โ€” no sign-up required.

Option 2: Install as a Desktop / Mobile App (Recommended)

Installing NoteBloom as a PWA gives you a native-feeling app with offline access.

On Desktop (Chrome or Edge):

  1. Open https://sammmiksha.github.io/notebloom/ in Chrome or Edge.
  2. Look for the install icon (โž•) in the address bar, or open the browser menu (โ‹ฎ) and click "Install NoteBloom".
  3. Click Install in the prompt.
  4. NoteBloom will appear in your Start Menu, Taskbar, or Desktop like any native app.

On Android (Chrome):

  1. Open the site in Chrome.
  2. Tap the menu (โ‹ฎ) โ†’ "Add to Home Screen".
  3. Tap Add. The app icon will appear on your home screen.

On iOS (Safari):

  1. Open the site in Safari.
  2. Tap the Share button (box with arrow) โ†’ "Add to Home Screen".
  3. Tap Add.

โ„น๏ธ Once installed, NoteBloom works fully offline. Your notes are saved locally on your device.


๐Ÿ“– How to Use NoteBloom

Creating a Notebook

  1. From the dashboard, click "+ New Notebook".
  2. Enter a name for your notebook (e.g., "Physics Lectures", "CS101").
  3. Your new notebook will appear as a card on the dashboard.

Opening and Writing Notes

  1. Click on any notebook card to open it.
  2. Start typing your notes in the editor.
  3. Use the toolbar to apply Bold (B), Italic (I), or Underline (U) formatting.
  4. Notes are auto-saved โ€” you'll see "All changes saved" in the bottom-right corner.

Choosing a Page Style

Use the dropdown in the toolbar to switch between:

  • Blank โ€” clean white canvas
  • Ruled โ€” horizontal lines, classic notebook style
  • Grid โ€” square grid, great for diagrams and math
  • Dot Grid โ€” subtle dots, popular for bullet journaling

Changing Themes

Use the theme dropdown (e.g., Purple) to change the color scheme of your editor. Pick the vibe that matches your mood or subject.

Pasting Screenshots

  1. Take a screenshot on your device (Win+Shift+S on Windows, Cmd+Shift+4 on Mac).
  2. Click inside your note area.
  3. Press Ctrl+V (or Cmd+V on Mac) โ€” the screenshot pastes directly into your note.

Renaming or Deleting a Notebook

  • On the dashboard, each notebook card shows Rename and Delete options beneath it.
  • Click Rename to give it a new title, or Delete to remove it permanently.

Searching Your Notebooks

  • Use the Search bar at the top of the dashboard to quickly find notebooks by name.

๐ŸŽจ Features Overview

Feature Details
๐Ÿ“’ Notebook Management Create, rename, and delete multiple notebooks
๐ŸŽจ Themes Multiple color themes to personalize your workspace
๐Ÿ“„ Page Styles Blank, Ruled, Grid, Dot Grid
๐Ÿ–ผ๏ธ Screenshot Pasting Paste images from clipboard directly into notes
๐Ÿ’พ Auto-Save Notes saved automatically using IndexedDB (browser storage)
๐Ÿ” Search Search across notebooks instantly
๐Ÿ“ฑ PWA / Installable Install on desktop or mobile like a native app
๐ŸŒ Offline Support Works without internet after first load
๐Ÿ”  Rich Text Bold, Italic, Underline formatting
๐Ÿ“ Font & Size Controls Adjust font family and size from the toolbar

๐Ÿ› ๏ธ Tech Stack

Technology Purpose
HTML5 App structure and markup
CSS3 Styling, themes, animations
Vanilla JavaScript All app logic and interactions
IndexedDB Local persistent storage for notes and notebooks
Service Workers Offline support and caching
Web App Manifest PWA installability (icons, name, theme color)
GitHub Pages Free static hosting for the live demo

No frameworks, no backend, no server โ€” NoteBloom runs entirely in your browser with zero dependencies.


๐Ÿ—‚๏ธ Project Structure

notebloom/
โ”œโ”€โ”€ assets/
โ”‚   โ”œโ”€โ”€ icon-192.png          # PWA icon (small)
โ”‚   โ”œโ”€โ”€ icon-512.png          # PWA icon (large)
โ”‚   โ”œโ”€โ”€ screenshot-wide.png   # Wide editor screenshot
โ”‚   โ””โ”€โ”€ screenshot-narrow.png # Narrow editor screenshot
โ”œโ”€โ”€ app.js                    # Core app logic & notebook management
โ”œโ”€โ”€ database.js               # IndexedDB storage layer
โ”œโ”€โ”€ editor.js                 # Note editor logic (formatting, page styles)
โ”œโ”€โ”€ index.css                 # Global styles and themes
โ”œโ”€โ”€ index.html                # Main app entry point
โ”œโ”€โ”€ manifest.json             # PWA manifest (icons, name, theme color)
โ””โ”€โ”€ service-worker.js         # Offline support and caching

๐Ÿ’ก Tips & Tricks

  • Snap it beside your lecture! Resize NoteBloom to a narrow window and snap it next to your video โ€” it's designed to look great at any width.
  • Use Grid pages for diagrams and equations โ€” the grid lines make freehand sketching in notes much cleaner.
  • Organize by subject โ€” create one notebook per course so your notes never get mixed up.
  • Screenshot workflow โ€” during a Zoom or Teams call, use your OS snipping tool and paste straight into your note without breaking flow.

๐Ÿ”ฎ Roadmap / Future Improvements

  • Always-on-top window mode (keep NoteBloom above your lecture window)
  • Electron desktop version (deeper OS integration)
  • Export notes as PDF or Markdown
  • More notebook cover themes and colors
  • Tagging and folder organization
  • Dark mode support
  • Handwriting / stylus input support

๐Ÿค Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/your-feature-name
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/your-feature-name
  5. Open a Pull Request

๐Ÿ“„ License

This project is open source and available under the MIT License.


Made with ๐ŸŒธ for students, by a student
Try NoteBloom Live โ†’

About

A cute installable study notebook PWA for lectures and meetings with offline support, notebook themes, page styles, and screenshot embedding.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors