Skip to content

sammmiksha/notebloom

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 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


โœจ 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.

With NoteBloom you can:

  • Organize notes into a bookshelf of notebooks, one per subject or course
  • Write 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
  • Switch between multiple themes to personalize your workspace
  • Use the built-in floating Study Calculator without leaving your notes
  • Work completely offline, with no internet needed after install
  • Install it like a native app on Windows, Mac, Android, or iOS

๐Ÿ“ธ Screenshots

Bookshelf Dashboard
NoteBloom bookshelf dashboard showing notebook shelves
Note Editor
NoteBloom note editor with formatting toolbar
Floating Study Calculator
Draggable floating study calculator over a note
Narrow / Mobile View
NoteBloom dashboard in a narrow mobile layout

Tip: The app adapts its layout to window size โ€” snap it beside your lecture video for a distraction-free note-taking experience.


๐Ÿš€ Getting Started

Option 1 โ€” Use in Browser (No Install)

Visit sammmiksha.github.io/notebloom and 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 full offline access.

Desktop (Chrome or Edge)

  1. Open sammmiksha.github.io/notebloom in Chrome or Edge.
  2. Click the install icon (โž•) in the address bar, or open the browser menu (โ‹ฎ) โ†’ Install NoteBloom.
  3. Click Install. NoteBloom now appears in your Start Menu, Taskbar, or Desktop like any native app.

Android (Chrome)

  1. Open the site in Chrome.
  2. Tap the menu (โ‹ฎ) โ†’ Add to Home Screen โ†’ Add.

iOS (Safari)

  1. Open the site in Safari.
  2. Tap Share โ†’ Add to Home Screen โ†’ Add.

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


๐Ÿ“– How to Use NoteBloom

Creating a notebook Click + New Notebook on the dashboard, name it (e.g. "Physics Lectures," "CS101"), and it appears on your bookshelf.

Writing notes Open any notebook and start typing. Use the toolbar for Bold, Italic, or Underline. Notes auto-save โ€” look for "All changes saved" in the bottom-right corner.

Choosing a page style Pick from Blank, Ruled, Grid, or Dot Grid in the toolbar dropdown, depending on how you like to write.

Changing themes Use the theme dropdown to switch the editor's color scheme to match your mood or subject.

Pasting screenshots Take a screenshot (Win+Shift+S on Windows, Cmd+Shift+4 on Mac), click inside your note, then paste with Ctrl+V / Cmd+V. It drops straight into your note.

Using the Study Calculator Tap the calculator FAB (floating action button) in the editor's bottom-right corner. On desktop, drag it anywhere โ€” it remembers its position between sessions. On mobile, it opens as a bottom-sheet so your writing area stays usable. You can also type expressions like 6 + 4 = directly into a note and they'll evaluate inline.

Renaming or deleting a notebook Each notebook card on the dashboard has Rename and Delete options beneath it.

Searching notebooks Use the search bar at the top of the dashboard to find a notebook by name instantly.


๐ŸŽจ Features Overview

Feature Details
๐Ÿ“š Bookshelf Organization Notebooks displayed on a customizable visual bookshelf
๐Ÿ“’ 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 via IndexedDB
๐Ÿ” Search Find notebooks instantly from the dashboard
๐Ÿงฎ Floating Calculator Draggable Study Calculator with session persistence
โž— Inline Math Type 6 + 4 = in a note and get the result 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)
โ”‚   โ””โ”€โ”€ screenshots/          # App screenshots used in this README
โ”œโ”€โ”€ 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

๐Ÿ“‹ Changelog

v1.1.0 โ€” Bookshelf, Floating Calculator & Mobile Polish

๐Ÿ“š Bookshelf Notebook Organization

  • New visual bookshelf layout for browsing and managing notebooks
  • Notebook spine and front-cover display modes
  • Multi-shelf arrangement with renameable shelves
  • Shelf customization and positioning controls

๐Ÿงฎ Responsive Study Calculator

  • Replaced the fixed sidebar calculator with a draggable floating window; position and open/close state persist between sessions
  • Tablet: calculator appears as a floating utility panel with a simplified interaction model
  • Mobile: calculator opens as a bottom-sheet panel so the full writing area stays usable

๐Ÿ“ฑ Mobile Math Solver Fix

  • Fixed automatic inline math evaluation on mobile devices
  • Expressions like 6 + 4 =, 7 ร— 7 =, and 12 / 3 = now evaluate correctly on Android and iOS virtual keyboards
  • Added input-eventโ€“based detection for = while preserving existing desktop keyboard support

โœจ UX Improvements

  • Added a Floating Action Button (FAB) for one-tap calculator access
  • Removed the old split-screen layout to improve editor workspace utilization
  • Added calculator close button and header controls
  • Improved responsive behavior across desktop, tablet, and mobile

๐ŸŽจ Theme & Persistence

  • Calculator now integrates cleanly with all existing themes
  • Calculator visibility and position remembered between sessions
  • All existing notebook data remains fully compatible โ€” no migration needed

๐Ÿ’ก Tips & Tricks

  • Snap it beside your lecture โ€” resize NoteBloom to a narrow window and dock it next to your video call; the layout is designed to look good at any width.
  • Use Grid pages for diagrams and equations โ€” the grid lines make freehand sketching much cleaner.
  • Organize by subject โ€” one notebook per course keeps your notes from getting mixed up.
  • Screenshot workflow โ€” during a Zoom or Teams call, use your OS snipping tool and paste straight into your note without breaking flow.
  • Keep the calculator handy โ€” drag it to a corner and leave it open; it'll be there next session.

๐Ÿ”ฎ Roadmap

  • Always-on-top window mode (keep NoteBloom above your lecture window)
  • Electron desktop version for 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.

  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