ryOS ryOS / Docs
GitHub Launch

Stickies

Stickies is a simple yet effective note-taking application for ryOS, designed to help users quickly jot down reminders and organize their thoughts directly on their digital desktop. It provides a flexible and visually distinct way to keep important information at your fingertips, enhancing productivity and information recall.

Overview

Stickies serves as a digital equivalent of physical sticky notes, allowing ryOS users to place colorful, resizable notes anywhere on their desktop. Its primary function is to provide an immediate and persistent solution for short-term reminders, task lists, and quick information storage. Users can create multiple notes, each customizable with various colors to categorize or prioritize information, making it an ideal tool for managing daily tasks and spontaneous ideas without cluttering their main workspace.

The application focuses on ease of use and visual organization. Notes remain visible and accessible, ensuring that important information is always at a glance. Whether for remembering a deadline, noting down a phone number, or outlining a quick idea, Stickies integrates seamlessly into the ryOS environment to enhance personal productivity and information recall.

Features

  • Quick Note Creation: Instantly generate new sticky notes to capture thoughts as they arise.
  • Customizable Colors: Assign different colors to notes for visual organization, categorization, or prioritization from the Note menu.
  • Flexible Placement & Sizing: Easily drag notes around the desktop by their title bar and resize them by dragging their corners to fit your content and preferred layout.
  • Individual Note Management: Delete individual notes by clicking the 'X' button on the note itself when they are no longer needed.
  • Bulk Note Management: Clear all active sticky notes from the desktop with a single action via File > Clear All Notes for a fresh start.
  • Persistent Storage: All notes are automatically saved and restored between ryOS sessions, ensuring your information is never lost.

User Guide

Getting Started

To launch Stickies, locate its icon in the ryOS application launcher and click on it. Upon opening, a new, blank sticky note will automatically appear on your desktop, ready for you to type in your first reminder.

Key Actions

  • Create a New Note: To add another sticky note, click on File in the menu bar, then select New Note.
  • Change Note Color: Select a note by clicking on it. Then, from the menu bar, click on Note and choose a color from the available options to visually distinguish your notes.
  • Move and Resize Notes: To reposition a sticky note, click and drag its title bar. To change its size, click and drag any of its corners.
  • Delete a Single Note: Each sticky note has an 'X' button in its top-right corner. Click this button to permanently remove that specific note.
  • Clear All Notes: If you wish to remove all sticky notes from your desktop at once, go to File in the menu bar and select Clear All Notes. Be aware that this action cannot be undone.

Tips & Shortcuts

  • Click to Focus: Click on any sticky note to bring it to the foreground and make it the active note, allowing you to edit its content or change its color.
  • Auto-Save Reliability: You don't need to manually save your notes; Stickies automatically saves all changes and note positions, ensuring they are present the next time you log into ryOS.
  • Organize Your Desktop: Use the drag and resize features to arrange your notes strategically around your ryOS desktop, perhaps grouping related tasks or placing high-priority items more prominently.

Technical Details

Window Configuration

  • Default size: 500×400px
  • Minimum size: 300×250px

Component Architecture

The app consists of the following component files:

Hooks & Utilities

Custom Hooks:
  • src/apps/stickies/hooks/useStickiesLogic.ts: This custom hook encapsulates the core business logic for the Stickies app, including state management for notes, handling note creation, deletion, color changes, and persistence.
Utility Files: No custom utility files are used in this application.

State Management

The Stickies app manages its state primarily through the useStickiesLogic custom hook. This hook handles the array of sticky notes, their individual properties (content, position, size, color), and the currently selected note. Note data is persisted automatically between ryOS sessions, likely utilizing browser local storage to ensure notes are saved and restored upon application launch.

Related Apps

  • Todo List: For more structured task management, the Todo List app can complement Stickies by providing detailed checklists and project tracking.
  • Notes: For longer-form writing and document creation, the Notes app offers a richer text editing experience beyond quick reminders.