📝 NoteBook - Desktop Note Taking Application

A simple desktop note management application built using C# Windows Forms and .NET Framework 4.7.2.

The application allows users to create, edit, delete, search, and manage personal notes with local JSON-based persistence using Newtonsoft.Json.

The project demonstrates practical desktop application development concepts including CRUD operations, data binding, file persistence, and basic separation of responsibilities.

---

📑 Table of Contents

• Features
• Technology Stack
• Architecture
• Design Patterns
• Data Persistence
• Installation
• Project Structure
• Limitations
• Future Improvements
• Contact

---

🚀 Features

➕ Create Notes

Users can create new notes containing:

• Title.
• Content.
• Automatic creation date.

Features:

• Validate required fields.
• Generate unique note ID.
• Save immediately to JSON storage.

Implemented through:

NoteManger.AddNote()

---

📋 View Notes

The application displays stored notes using:

DataGridView

Displayed information:

• Note ID.
• Title.
• Created Date.

Data retrieval:

NoteManger.GetAllNotes()

---

✏️ Update Notes

Users can modify existing notes.

Features:

• Select note from DataGridView.
• Edit title and content.
• Save changes immediately.

Implemented through:

NoteManger.UpdateNote()

---

🗑 Delete Notes

Users can remove notes from storage.

Features:

• Delete selected note.
• Update JSON file automatically.

Implemented through:

NoteManger.DeleteNote()

---

🔍 Search Notes

The application supports searching notes by title.

Features:

• Case-insensitive search.
• Partial title matching.

Implementation:

NoteManger.SearchByTitle()

Note:

• The current implementation returns the first matching note.

---

📋 Clipboard Operations

The application supports text editing operations:

• Copy.
• Paste.
• Cut.

Implemented using Windows Forms TextBox clipboard functionality.

---

🧹 New Note / Clear State

The UI supports:

• Creating a new empty note.
• Clearing current input fields.
• Managing DataGridView selection state.

---

🏛 Architecture

The project follows a simple layered desktop architecture:

NoteBook Application

        |
        ↓

 Presentation Layer
      Form1

        |
        ↓

 Domain Model
      Note

        |
        ↓

 Persistence Layer
   NoteManger

        |
        ↓

   notes.json

---

🖥 Presentation Layer

Main component:

Form1

Responsibilities:

• Display user interface.
• Handle button events.
• Manage user interaction.
• Bind data to DataGridView.

Main files:

Form1.cs
Form1.Designer.cs
Form1.resx

---

📦 Domain Model

Class:

Note

Properties:

Id
Title
Content
CreatedDate

Responsibilities:

• Represent note data.
• Transfer information between layers.

---

💾 Persistence Layer

Class:

NoteManger

Responsibilities:

• Manage note collection.
• Perform CRUD operations.
• Read and write JSON file.
• Generate unique IDs.

Storage:

notes.json

---

🧩 Design Patterns

Repository-Like Pattern

NoteManger works as a repository abstraction.

Responsibilities:

• Hide storage details.
• Provide CRUD methods.
• Manage persistence operations.

---

POCO / DTO Model

Note is a simple data object containing:

Data
+
Properties

without complex business logic.

---

Data Binding

The application uses:

DataGridView.DataSource

to display note information.

---

🛠 Technology Stack

Category	Technology
Language	C#
Framework	.NET Framework 4.7.2
UI Framework	Windows Forms
Storage	JSON File
JSON Library	Newtonsoft.Json 13.0.4
IDE	Visual Studio
Build System	MSBuild
File Handling	System.IO
Input Dialog	Microsoft.VisualBasic InputBox
Version Control	Git

---

🗄 Data Persistence

The application stores data locally.

Storage file:

notes.json

Behavior:

• If the file does not exist, an empty note list is created.
• Every add/update/delete operation saves changes immediately.
• CreatedDate is generated automatically:

DateTime.Now

---

⚙ Installation

Requirements

Install:

• Windows Operating System.
• Visual Studio 2022 or compatible version.
• .NET Framework 4.7.2 Developer Pack.

---

Setup

1. Clone the repository:

git clone <repository-url>

2. Open solution:

NoteBook.sln

3. Restore NuGet packages.

Required package:

Newtonsoft.Json 13.0.4

4. Build the solution.

5. Run:

F5

---

📂 Project Structure

NoteBook
│
├── NoteBook.sln
│
├── NoteBook.csproj
│
├── Program.cs
│
├── Form1.cs
├── Form1.Designer.cs
├── Form1.resx
│
├── Note.cs
│
├── NoteManger.cs
│
├── packages
│   └── Newtonsoft.Json
│
└── README.md

---

📝 Runtime Behavior

When the application starts:

1. Checks for:

notes.json

2. If unavailable:

Creates empty note collection

3. Loads existing notes.

4. Displays them inside DataGridView.

---

⚠️ Limitations

Current limitations:

• Designed for single-user desktop usage.
• No synchronization for multiple processes.
• Minimal handling for corrupted JSON files.
• Minimal file I/O exception handling.
• Search returns only the first matching result.
• No automated tests.
• No CI/CD pipeline.
• No installer.
• No license file included.

---

🔮 Future Improvements

Possible improvements:

• Add Repository Pattern with interfaces.
• Separate Business Logic from UI.
• Add centralized exception handling.
• Add logging system.
• Add backup and restore functionality.
• Add rich text editing.
• Add categories and tags.
• Add note reminders.
• Add unit tests.
• Add automatic updates.
• Create application installer.

---

📧 Contact

Albara Fahed Alharissy

Software Engineer | C# .NET Developer

GitHub:

https://github.com/Albarafahed

LinkedIn:

https://www.linkedin.com/in/albara-csharp-developer/