diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/README.md
new file mode 100644
index 0000000..54f0c0b
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/README.md
@@ -0,0 +1,188 @@
+# 🔋 ThreeByte.LinkLib.NetBooter
+
+**Client library for controlling Synaccess NetBooter networked power controllers — toggle outlets, poll state, and monitor power remotely.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.NetBooter?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.NetBooter)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔋 **Outlet Control** | Turn individual power outlets on and off programmatically |
+| 📊 **State Polling** | Query all outlet states in a single call |
+| 🔔 **Property Change Notifications** | Implements `INotifyPropertyChanged` for UI data binding |
+| 🌐 **HTTP-Based** | Communicates via the NetBooter's built-in web API |
+| ⚠️ **Error Events** | Event-driven error reporting |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.NetBooter
+```
+
+or via the NuGet Package Manager:
+
+```
+Install-Package ThreeByte.LinkLib.NetBooter
+```
+
+---
+
+## 🚀 Quick Start
+
+```csharp
+using ThreeByte.LinkLib.NetBooter;
+
+// Connect to a NetBooter device
+var netBooter = new NetBooterLink("192.168.1.10");
+
+// Subscribe to errors
+netBooter.ErrorOccurred += (s, ex) =>
+    Console.WriteLine($"Error: {ex.Message}");
+
+// Turn on outlet 1
+netBooter.Power(outlet: 1, state: true);
+
+// Turn off outlet 3
+netBooter.Power(outlet: 3, state: false);
+
+// Poll all outlet states from the device
+netBooter.PollState();
+
+// Check individual outlet states
+bool outlet1 = netBooter[1];  // true = ON
+bool outlet2 = netBooter[2];  // false = OFF
+Console.WriteLine($"Outlet 1: {(outlet1 ? "ON" : "OFF")}");
+Console.WriteLine($"Outlet 2: {(outlet2 ? "ON" : "OFF")}");
+```
+
+### WPF / MVVM Data Binding
+
+`NetBooterLink` implements `INotifyPropertyChanged`, making it easy to bind to UI:
+
+```xml
+<!-- XAML -->
+<StackPanel DataContext="{Binding NetBooter}">
+    <TextBlock Text="{Binding [1], StringFormat='Outlet 1: {0}'}" />
+    <TextBlock Text="{Binding [2], StringFormat='Outlet 2: {0}'}" />
+    <Button Content="Refresh" Command="{Binding PollCommand}" />
+</StackPanel>
+```
+
+---
+
+## 📖 API Reference
+
+### `NetBooterLink`
+
+#### Constructor
+
+```csharp
+NetBooterLink(string ipAddress)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `this[int port]` | `bool` | Indexer — get the power state of outlet N (`true` = ON) |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `Power(int outlet, bool state)` | `void` | Set outlet power: `true` = ON, `false` = OFF |
+| `PollState()` | `void` | Query all outlet states from the device |
+
+#### Events
+
+| Event | Args | Description |
+|-------|------|-------------|
+| `PropertyChanged` | `PropertyChangedEventArgs` | Fires when an outlet state changes (INotifyPropertyChanged) |
+| `ErrorOccurred` | `Exception` | Fires on communication errors |
+
+---
+
+## 🏗️ Architecture
+
+```
+┌──────────────────────────────────────────────┐
+│              NetBooterLink                    │
+│                                              │
+│  Power(outlet, state) ─────┐                 │
+│                             ▼                │
+│                  ┌─────────────────────┐     │
+│                  │  HTTP Commands      │     │
+│                  │                     │     │
+│                  │  SET:  $A3 {o} {s}  │     │
+│                  │  POLL: $A5          │     │
+│                  └────────┬────────────┘     │
+│                           │                  │
+│                           ▼                  │
+│                  ┌─────────────────────┐     │
+│                  │  NetBooter Device   │     │
+│                  │  http://{ip}/       │     │
+│                  │  cmd.cgi            │     │
+│                  └─────────────────────┘     │
+│                           │                  │
+│  PollState() ─────────────┘                  │
+│       │                                      │
+│       ▼                                      │
+│  ┌─────────────────────────────────────────┐ │
+│  │  Outlet State Dictionary                │ │
+│  │  { 1: ON, 2: OFF, 3: ON, ... }         │ │
+│  └─────────────────────────────────────────┘ │
+│       │                                      │
+│       ▼                                      │
+│  PropertyChanged events → UI binding         │
+└──────────────────────────────────────────────┘
+```
+
+---
+
+## 🔧 How It Works
+
+The library communicates with Synaccess NetBooter devices via their HTTP CGI interface:
+
+| Operation | HTTP Request | Example |
+|-----------|-------------|---------|
+| **Power On** outlet 1 | `GET /cmd.cgi?$A3 1 1` | Turns on outlet 1 |
+| **Power Off** outlet 2 | `GET /cmd.cgi?$A3 2 0` | Turns off outlet 2 |
+| **Poll State** | `GET /cmd.cgi?$A5` | Returns binary string of all outlet states |
+
+### State Response Format
+
+The device returns a binary string where each bit (right-to-left) represents an outlet:
+
+```
+Response: "1101"
+           ||||
+           |||└─ Outlet 1: ON
+           ||└── Outlet 2: OFF
+           |└─── Outlet 3: ON
+           └──── Outlet 4: ON
+```
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows | ✅ |
+| Linux | ✅ |
+| macOS | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/Three-Byte/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/ThreeByte.LinkLib.NetBooter.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/ThreeByte.LinkLib.NetBooter.csproj
index ec69a40..3cbdfae 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/ThreeByte.LinkLib.NetBooter.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.NetBooter/ThreeByte.LinkLib.NetBooter.csproj
@@ -4,8 +4,13 @@
     <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\ThreeByte.LinkLib.Shared\ThreeByte.LinkLib.Shared.csproj" />
   </ItemGroup>
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/README.md
new file mode 100644
index 0000000..0ccc607
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/README.md
@@ -0,0 +1,208 @@
+# 🎬 ThreeByte.LinkLib.ProjectorLink
+
+**PJLink protocol client for controlling projectors over TCP — power on/off, state queries, and device info.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.ProjectorLink?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.ProjectorLink)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🎬 **PJLink 1.0** | Full implementation of the PJLink Class 1 protocol |
+| 🔐 **Authentication** | MD5 password authentication when required by projector |
+| ⚡ **Power Control** | Turn projectors on and off programmatically |
+| 📊 **State Queries** | Query power state: Off, On, Cooling, Warming Up |
+| ℹ️ **Device Info** | Retrieve manufacturer, product name, and projector name |
+| 🔔 **Error Events** | Event-driven error reporting |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.ProjectorLink
+```
+
+or via the NuGet Package Manager:
+
+```
+Install-Package ThreeByte.LinkLib.ProjectorLink
+```
+
+---
+
+## 🚀 Quick Start
+
+```csharp
+using ThreeByte.LinkLib.ProjectorLink;
+
+// Connect to a projector (default PJLink port 4352)
+using var projector = new Projector("192.168.1.200");
+
+// Power on
+bool success = projector.TurnOn();
+Console.WriteLine(success ? "✅ Projector turning on" : "❌ Power on failed");
+
+// Query state
+PowerStatus status = projector.GetState();
+Console.WriteLine($"Status: {status}");
+// Output: Status: WARMUP → ON
+
+// Get device info
+string info = projector.GetInfo();
+Console.WriteLine($"Projector: {info}");
+// Output: Projector: Epson EB-L1755U (Main Hall)
+
+// Power off
+projector.TurnOff();
+```
+
+### With Authentication
+
+```csharp
+// Some projectors require a password
+using var projector = new Projector("192.168.1.200", password: "admin123");
+
+projector.ErrorOccurred += (s, ex) =>
+    Console.WriteLine($"Projector error: {ex.Message}");
+
+projector.TurnOn();
+```
+
+### Custom Port
+
+```csharp
+// Non-standard PJLink port
+using var projector = new Projector("10.0.0.50", port: 5000, password: "secret");
+```
+
+---
+
+## 📖 API Reference
+
+### `Projector`
+
+#### Constructors
+
+```csharp
+Projector(string host)                                    // Default port 4352, no auth
+Projector(string host, int port)                          // Custom port, no auth
+Projector(string host, string password)                   // Default port, with auth
+Projector(string host, int port, string password)         // Custom port + auth
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Address` | `string` | Formatted as `"host/port"` |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `TurnOn()` | `bool` | Sends power-on command. Returns `true` on success |
+| `TurnOff()` | `bool` | Sends power-off command. Returns `true` on success |
+| `GetState()` | `PowerStatus` | Queries the current power state |
+| `GetInfo()` | `string` | Returns `"Manufacturer Product (Name)"` |
+| `Dispose()` | `void` | Releases resources |
+
+#### Events
+
+| Event | Args | Description |
+|-------|------|-------------|
+| `ErrorOccurred` | `Exception` | Fires on communication or protocol errors |
+
+---
+
+### `PowerStatus` Enum
+
+| Value | Int | Description |
+|-------|-----|-------------|
+| `OFF` | 0 | Projector is powered off |
+| `ON` | 1 | Projector is running normally |
+| `COOLING` | 2 | Projector is cooling down after power-off |
+| `WARMUP` | 3 | Projector lamp is warming up after power-on |
+| `UNKNOWN` | 4 | State could not be determined |
+
+### `CommandResponse` Enum
+
+| Value | Description |
+|-------|-------------|
+| `SUCCESS` | Command executed successfully |
+| `UNDEFINED_CMD` | Projector does not recognize the command |
+| `OUT_OF_PARAMETER` | Invalid parameter sent |
+| `UNAVAILABLE_TIME` | Command not available in current state |
+| `PROJECTOR_FAILURE` | Projector hardware error |
+| `AUTH_FAILURE` | Authentication failed |
+| `COMMUNICATION_ERROR` | Network or protocol error |
+
+---
+
+## 🏗️ Architecture
+
+```
+┌──────────────────────────────────────────┐
+│               Projector                  │
+│                                          │
+│  TurnOn() ──┐                            │
+│  TurnOff()──┤  ┌──────────────────────┐  │
+│  GetState()─┤  │    PJLink Commands   │  │
+│  GetInfo()──┘  │                      │  │
+│                │  PowerCommand        │  │
+│                │  ManufacturerName     │  │
+│                │  ProductName         │  │
+│                │  ProjectorName       │  │
+│                └──────────┬───────────┘  │
+│                           │              │
+│                           ▼              │
+│                ┌──────────────────────┐   │
+│                │  TCP Connection      │   │
+│                │  (per-command)       │   │
+│                │                      │   │
+│                │  ┌────────────────┐  │   │
+│                │  │ MD5 Auth       │  │   │
+│                │  │ (if required)  │  │   │
+│                │  └────────────────┘  │   │
+│                └──────────────────────┘   │
+└──────────────────────────────────────────┘
+```
+
+---
+
+## 📋 PJLink Protocol Reference
+
+This library implements the [PJLink](https://pjlink.jbmia.or.jp/english/) Class 1 specification:
+
+| PJLink Command | Method | Description |
+|----------------|--------|-------------|
+| `%1POWR 1` | `TurnOn()` | Power on |
+| `%1POWR 0` | `TurnOff()` | Power off |
+| `%1POWR ?` | `GetState()` | Query power status |
+| `%1INF1 ?` | (via `GetInfo()`) | Query manufacturer |
+| `%1INF2 ?` | (via `GetInfo()`) | Query product name |
+| `%1NAME ?` | (via `GetInfo()`) | Query projector name |
+
+> **Default PJLink port:** TCP 4352
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows | ✅ |
+| Linux | ✅ |
+| macOS | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/olaafrossi/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/ThreeByte.LinkLib.ProjectorLink.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/ThreeByte.LinkLib.ProjectorLink.csproj
index 3f9cdcd..526214a 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/ThreeByte.LinkLib.ProjectorLink.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.ProjectorLink/ThreeByte.LinkLib.ProjectorLink.csproj
@@ -4,8 +4,13 @@
     <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.7" />
   </ItemGroup>
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/README.md
new file mode 100644
index 0000000..7b1e5f4
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/README.md
@@ -0,0 +1,248 @@
+# 🔌 ThreeByte.LinkLib.SerialLink
+
+**Serial port (RS-232) communication with optional frame-based protocol support, auto-reconnection, and message queuing.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.SerialLink?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.SerialLink)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔌 **RS-232 Support** | Full serial port configuration — baud rate, data bits, parity |
+| 📐 **Frame Protocol** | Optional header/footer framing via `FramedSerialLink` |
+| 🔄 **Auto-Reconnect** | Automatically recovers from serial port errors |
+| 📦 **Message Queuing** | Incoming data queued FIFO (up to 100 messages) |
+| 🔒 **Thread-Safe** | All operations protected with locks |
+| 🔔 **Event-Driven** | Connection changes, data arrival, and error events |
+| 🎛️ **Enable/Disable** | Pause and resume without closing the port |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.SerialLink
+```
+
+or via the NuGet Package Manager:
+
+```
+Install-Package ThreeByte.LinkLib.SerialLink
+```
+
+---
+
+## 🚀 Quick Start
+
+### Raw Serial Communication
+
+```csharp
+using ThreeByte.LinkLib.SerialLink;
+
+// Open a serial port at 9600 baud
+var serial = new SerialLink("COM3", baudRate: 9600);
+
+// Subscribe to events
+serial.IsConnectedChanged += (s, connected) =>
+    Console.WriteLine(connected ? "✅ Port open" : "❌ Port closed");
+
+serial.DataReceived += (s, e) =>
+{
+    byte[]? data = serial.GetMessage();
+    if (data != null)
+        Console.WriteLine($"Received {data.Length} bytes");
+};
+
+// Send raw bytes
+byte[] command = new byte[] { 0x01, 0x02, 0x03 };
+serial.SendData(command);
+
+// Check for queued data
+while (serial.HasData)
+{
+    byte[]? response = serial.GetMessage();
+}
+
+serial.Dispose();
+```
+
+### Framed Serial Communication
+
+Use `FramedSerialLink` when your device protocol uses header/footer delimiters:
+
+```csharp
+using ThreeByte.LinkLib.SerialLink;
+
+var framed = new FramedSerialLink("COM4", baudRate: 115200);
+
+// Configure frame delimiters
+framed.SendFrame = new SerialFrame
+{
+    Header = new byte[] { 0x02 },  // STX
+    Footer = new byte[] { 0x03 }   // ETX
+};
+
+framed.ReceiveFrame = new SerialFrame
+{
+    Header = new byte[] { 0x02 },
+    Footer = new byte[] { 0x03 }
+};
+
+// Send a framed message — header/footer added automatically
+framed.SendMessage("STATUS?");
+// Wire: [0x02] S T A T U S ? [0x03]
+
+// Receive complete framed messages
+framed.DataReceived += (s, e) =>
+{
+    string? response = framed.GetMessage();
+    Console.WriteLine($"Device says: {response}");
+};
+
+framed.Dispose();
+```
+
+---
+
+## 📖 API Reference
+
+### `SerialLink` — Raw Serial Port
+
+#### Constructors
+
+```csharp
+SerialLink(string comPort, int baudRate = 9600, int dataBits = 8,
+           Parity parity = Parity.None, bool enabled = true)
+SerialLink(SerialLinkSettings settings, bool enabled = true)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `IsConnected` | `bool` | Whether the serial port is open and active |
+| `IsEnabled` | `bool` | Whether messaging is active |
+| `IsOpen` | `bool` | Whether the underlying port is open |
+| `HasData` | `bool` | Whether there are queued messages |
+| `ComPort` | `string` | The COM port name (e.g., `"COM3"`) |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `SendData(byte[])` | `void` | Sends raw bytes over the serial port |
+| `GetMessage()` | `byte[]?` | Dequeues the next incoming byte array (FIFO) |
+| `SetEnabled(bool)` | `void` | Enables or disables communication |
+| `Dispose()` | `void` | Closes the port and releases resources |
+
+---
+
+### `FramedSerialLink` — Framed Protocol
+
+#### Constructors
+
+```csharp
+FramedSerialLink(string comPort, int baudRate = 9600, int dataBits = 8,
+                 Parity parity = Parity.None, bool enabled = true)
+FramedSerialLink(SerialLinkSettings settings, bool enabled = true)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `SendFrame` | `SerialFrame` | Header/footer config for outgoing messages |
+| `ReceiveFrame` | `SerialFrame` | Header/footer config for incoming messages |
+| `IsConnected` | `bool` | Whether the underlying serial port is connected |
+| `IsEnabled` | `bool` | Whether messaging is active |
+| `HasData` | `bool` | Whether there are complete framed messages queued |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `SendMessage(string)` | `void` | Sends a string message wrapped in the configured frame |
+| `GetMessage()` | `string?` | Dequeues the next complete framed message (FIFO) |
+| `SetEnabled(bool)` | `void` | Enables or disables communication |
+| `Dispose()` | `void` | Closes the port and releases resources |
+
+---
+
+### `SerialFrame` — Frame Configuration
+
+```csharp
+var frame = new SerialFrame
+{
+    Header = new byte[] { 0x02 },  // Start-of-text
+    Footer = new byte[] { 0x0D, 0x0A }  // CR+LF
+};
+```
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Header` | `byte[]` | Bytes prepended to every outgoing message / expected at start of incoming |
+| `Footer` | `byte[]` | Bytes appended to every outgoing message / expected at end of incoming |
+
+---
+
+## 🏗️ Architecture
+
+```
+┌──────────────────────────────────────────────────┐
+│                  FramedSerialLink                 │
+│  ┌────────────┐           ┌────────────────────┐ │
+│  │ SendFrame  │           │   ReceiveFrame     │ │
+│  │ [HDR][MSG] │           │ Detect [HDR]..     │ │
+│  │     [FTR]  │           │         ..[FTR]    │ │
+│  └─────┬──────┘           └────────┬───────────┘ │
+│        │                           │             │
+│        ▼                           ▼             │
+│  ┌──────────────────────────────────────────────┐│
+│  │               SerialLink (Raw)               ││
+│  │                                              ││
+│  │  COM Port ←→ Read/Write ←→ Message Queue     ││
+│  │                   ↕                          ││
+│  │           Auto-Reconnect Timer               ││
+│  └──────────────────────────────────────────────┘│
+└──────────────────────────────────────────────────┘
+```
+
+---
+
+## 🔧 Configuration
+
+Use `SerialLinkSettings` for structured configuration:
+
+```csharp
+var settings = new SerialLinkSettings("COM3", 9600, 8, Parity.None);
+var serial = new SerialLink(settings);
+```
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `ComPort` | `string` | — | Serial port name (e.g., `"COM3"`, `"/dev/ttyUSB0"`) |
+| `BaudRate` | `int` | `9600` | Communication speed |
+| `DataBits` | `int` | `8` | Data bits per byte |
+| `Parity` | `Parity` | `None` | Parity checking mode |
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows (`COM1`..`COM256`) | ✅ |
+| Linux (`/dev/ttyUSB0`, `/dev/ttyS0`) | ✅ |
+| macOS (`/dev/tty.usbserial`) | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/olaafrossi/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/ThreeByte.LinkLib.SerialLink.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/ThreeByte.LinkLib.SerialLink.csproj
index 2ab1895..3053fcd 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/ThreeByte.LinkLib.SerialLink.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.SerialLink/ThreeByte.LinkLib.SerialLink.csproj
@@ -4,8 +4,13 @@
     <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="System.IO.Ports" Version="9.0.2" />
   </ItemGroup>
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/README.md
new file mode 100644
index 0000000..5664e4b
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/README.md
@@ -0,0 +1,124 @@
+# 🧩 ThreeByte.LinkLib.Shared
+
+**Shared logging infrastructure for all ThreeByte.LinkLib packages — consistent, standardized console logging via `Microsoft.Extensions.Logging`.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.Shared?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.Shared)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🧩 **Shared Foundation** | Common utilities used by all LinkLib packages |
+| 📋 **Structured Logging** | Built on `Microsoft.Extensions.Logging` for standardized output |
+| 🖥️ **Console Output** | Pre-configured console logging provider |
+| 🏭 **Logger Factory** | Simple `LogFactory.Create<T>()` API for creating typed loggers |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.Shared
+```
+
+> **Note:** This package is automatically included as a dependency when you install any other ThreeByte.LinkLib package (TcpLink, UdpLink, SerialLink, ProjectorLink, or NetBooter).
+
+---
+
+## 🚀 Quick Start
+
+```csharp
+using ThreeByte.LinkLib.Shared;
+
+// Create a typed logger for your class
+ILogger logger = LogFactory.Create<MyService>();
+
+logger.LogInformation("Service started on port {Port}", 8080);
+logger.LogWarning("Connection attempt timed out");
+logger.LogError("Failed to send data: {Error}", ex.Message);
+```
+
+---
+
+## 📖 API Reference
+
+### `LogFactory`
+
+A static factory that creates pre-configured `ILogger` instances with console output.
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `Create<T>()` | `ILogger` | Creates a console logger with the category name of type `T` |
+
+#### Example Output
+
+```
+info: MyApp.DeviceController[0]
+      Connected to projector at 192.168.1.200
+warn: MyApp.DeviceController[0]
+      Reconnection attempt #3
+```
+
+---
+
+## 🏗️ How It Fits Together
+
+```
+┌──────────────────────────────────────────────────┐
+│              Your Application                     │
+└────────┬──────────┬──────────┬──────────┬────────┘
+         │          │          │          │
+         ▼          ▼          ▼          ▼
+    ┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐
+    │ TcpLink │ │UdpLink │ │Serial  │ │Projector│
+    │         │ │        │ │ Link   │ │  Link   │
+    └────┬────┘ └───┬────┘ └───┬────┘ └────┬────┘
+         │          │          │           │
+         └──────────┴──────┬───┴───────────┘
+                           │
+                           ▼
+              ┌─────────────────────────┐
+              │   ThreeByte.LinkLib     │
+              │       .Shared          │
+              │                        │
+              │  LogFactory.Create<T>()│
+              │         │              │
+              │         ▼              │
+              │  Microsoft.Extensions  │
+              │     .Logging.Console   │
+              └─────────────────────────┘
+```
+
+---
+
+## 📚 Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `Microsoft.Extensions.Logging` | 9.0.2 | Core logging abstractions |
+| `Microsoft.Extensions.Logging.Abstractions` | 9.0.2 | `ILogger` interface |
+| `Microsoft.Extensions.Logging.Console` | 9.0.2 | Console output provider |
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows | ✅ |
+| Linux | ✅ |
+| macOS | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/olaafrossi/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/ThreeByte.LinkLib.Shared.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/ThreeByte.LinkLib.Shared.csproj
index 0ccccae..acb92a9 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/ThreeByte.LinkLib.Shared.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.Shared/ThreeByte.LinkLib.Shared.csproj
@@ -4,8 +4,13 @@
     <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.2" />
     <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="9.0.2" />
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/README.md
new file mode 100644
index 0000000..20e6582
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/README.md
@@ -0,0 +1,164 @@
+# 🌐 ThreeByte.LinkLib.TcpLink
+
+**Asynchronous TCP client with automatic reconnection, message queuing, and thread-safe operation.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.TcpLink?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.TcpLink)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔄 **Auto-Reconnect** | Automatically re-establishes connections with a 3-second retry on failure |
+| 📦 **Message Queuing** | Incoming data is queued (FIFO, up to 100 messages) for reliable retrieval |
+| 🔒 **Thread-Safe** | All operations are protected with locking for concurrent access |
+| ⚡ **Fully Async** | Uses `BeginConnect` / `BeginRead` / `BeginWrite` for non-blocking I/O |
+| 🔔 **Event-Driven** | Rich event model for connection changes, data arrival, and errors |
+| 🎛️ **Enable/Disable** | Pause and resume communication without destroying the connection |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.TcpLink
+```
+
+or via the NuGet Package Manager:
+
+```
+Install-Package ThreeByte.LinkLib.TcpLink
+```
+
+---
+
+## 🚀 Quick Start
+
+```csharp
+using ThreeByte.LinkLib.TcpLink;
+
+// Create a TCP link to a remote device
+var tcp = new AsyncTcpLink("192.168.1.100", 5000);
+
+// Subscribe to events
+tcp.IsConnectedChanged += (s, connected) =>
+    Console.WriteLine(connected ? "✅ Connected" : "❌ Disconnected");
+
+tcp.DataReceived += (s, e) =>
+    Console.WriteLine($"Data arrived: {tcp.GetMessage()?.Length} bytes");
+
+tcp.ErrorOccurred += (s, ex) =>
+    Console.WriteLine($"Error: {ex.Message}");
+
+// Send a message
+byte[] command = System.Text.Encoding.ASCII.GetBytes("HELLO\r\n");
+tcp.SendMessage(command);
+
+// Retrieve queued incoming data
+if (tcp.HasData)
+{
+    byte[]? response = tcp.GetMessage();
+}
+
+// Clean up
+tcp.Dispose();
+```
+
+---
+
+## 📖 API Reference
+
+### `AsyncTcpLink`
+
+#### Constructors
+
+```csharp
+AsyncTcpLink(string address, int port)
+AsyncTcpLink(string address, int port, bool enabled = true)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `IsConnected` | `bool` | Whether the TCP socket is currently connected |
+| `IsEnabled` | `bool` | Whether messaging is active |
+| `Address` | `string` | Remote host address |
+| `Port` | `int` | Remote host port |
+| `HasData` | `bool` | Whether there are queued incoming messages |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `SendMessage(byte[])` | `void` | Sends a byte array to the remote host |
+| `GetMessage()` | `byte[]?` | Dequeues and returns the next incoming message (FIFO) |
+| `SetEnabled(bool)` | `void` | Enables or disables communication |
+| `Dispose()` | `void` | Releases all resources and closes the connection |
+
+#### Events
+
+| Event | Args | Description |
+|-------|------|-------------|
+| `IsConnectedChanged` | `bool` | Fires when connection state changes |
+| `IsEnabledChanged` | `bool` | Fires when enabled state changes |
+| `ErrorOccurred` | `Exception` | Fires on communication errors |
+| `DataReceived` | `EventArgs` | Fires when new data arrives |
+
+---
+
+## 🔧 Configuration
+
+Use `TcpLinkSettings` for structured configuration:
+
+```csharp
+var settings = new TcpLinkSettings("192.168.1.100", 5000);
+// Access settings.Address, settings.Port
+```
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│              AsyncTcpLink                   │
+│                                             │
+│  ┌───────────┐  ┌───────────┐  ┌─────────┐ │
+│  │  Connect   │  │   Read    │  │  Write  │ │
+│  │  (Async)   │  │  (Async)  │  │ (Async) │ │
+│  └─────┬─────┘  └─────┬─────┘  └────┬────┘ │
+│        │              │              │      │
+│        ▼              ▼              ▼      │
+│  ┌─────────────────────────────────────────┐│
+│  │         Thread-Safe Message Queue       ││
+│  │            (FIFO, max 100)              ││
+│  └─────────────────────────────────────────┘│
+│        │                                    │
+│        ▼                                    │
+│  ┌─────────────────────────────────────────┐│
+│  │     Auto-Reconnect Timer (3 sec)        ││
+│  └─────────────────────────────────────────┘│
+└─────────────────────────────────────────────┘
+```
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows | ✅ |
+| Linux | ✅ |
+| macOS | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/olaafrossi/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/ThreeByte.LinkLib.TcpLink.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/ThreeByte.LinkLib.TcpLink.csproj
index ec69a40..3cbdfae 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/ThreeByte.LinkLib.TcpLink.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.TcpLink/ThreeByte.LinkLib.TcpLink.csproj
@@ -4,8 +4,13 @@
     <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\ThreeByte.LinkLib.Shared\ThreeByte.LinkLib.Shared.csproj" />
   </ItemGroup>
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/README.md b/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/README.md
new file mode 100644
index 0000000..7aa54bb
--- /dev/null
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/README.md
@@ -0,0 +1,191 @@
+# 📡 ThreeByte.LinkLib.UdpLink
+
+**Asynchronous UDP client with message queuing, configurable endpoints, and thread-safe operation.**
+
+[![NuGet](https://img.shields.io/nuget/v/ThreeByte.LinkLib.UdpLink?color=blue&logo=nuget)](https://www.nuget.org/packages/ThreeByte.LinkLib.UdpLink)
+![.NET](https://img.shields.io/badge/.NET-10.0%20%7C%20Standard%202.0%20%7C%20Standard%202.1-purple?logo=dotnet)
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 📡 **Connectionless** | Low-latency UDP datagrams — no handshake overhead |
+| 📦 **Message Queuing** | Incoming datagrams queued FIFO (up to 100 messages) |
+| 🔒 **Thread-Safe** | All operations protected with locking |
+| ⚡ **Fully Async** | Non-blocking `BeginSend` / `BeginReceive` patterns |
+| 🎛️ **Dual Port Config** | Separate remote and local port configuration |
+| 🔔 **Event-Driven** | Events for data arrival, errors, and enable/disable state |
+
+---
+
+## 📦 Installation
+
+```
+dotnet add package ThreeByte.LinkLib.UdpLink
+```
+
+or via the NuGet Package Manager:
+
+```
+Install-Package ThreeByte.LinkLib.UdpLink
+```
+
+---
+
+## 🚀 Quick Start
+
+```csharp
+using ThreeByte.LinkLib.UdpLink;
+
+// Send to a remote device on port 9000, listen on local port 9001
+var udp = new AsyncUdpLink("192.168.1.50", remotePort: 9000, localPort: 9001);
+
+// Subscribe to incoming data
+udp.DataReceived += (s, e) =>
+{
+    byte[]? data = udp.GetMessage();
+    if (data != null)
+        Console.WriteLine($"Received {data.Length} bytes");
+};
+
+udp.ErrorOccurred += (s, ex) =>
+    Console.WriteLine($"Error: {ex.Message}");
+
+// Send a datagram
+byte[] payload = System.Text.Encoding.ASCII.GetBytes("PING");
+udp.SendMessage(payload);
+
+// Check for queued data
+while (udp.HasData)
+{
+    byte[]? response = udp.GetMessage();
+}
+
+// Clean up
+udp.Dispose();
+```
+
+### Dynamic Local Port
+
+```csharp
+// Let the OS assign a local port (default behavior)
+var udp = new AsyncUdpLink("10.0.0.1", remotePort: 8080);
+```
+
+---
+
+## 📖 API Reference
+
+### `AsyncUdpLink`
+
+#### Constructors
+
+```csharp
+AsyncUdpLink(string address, int remotePort, int localPort = 0, bool enabled = true)
+AsyncUdpLink(UdpLinkSettings settings, bool enabled = true)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `IsEnabled` | `bool` | Whether the link is actively receiving |
+| `Address` | `string` | Remote host address |
+| `Port` | `int` | Remote port number |
+| `HasData` | `bool` | Whether there are queued incoming datagrams |
+
+#### Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `SendMessage(byte[])` | `void` | Sends a byte array datagram to the remote endpoint |
+| `GetMessage()` | `byte[]?` | Dequeues the next incoming datagram (FIFO) |
+| `SetEnabled(bool)` | `void` | Starts or stops the receive loop |
+| `Dispose()` | `void` | Releases the UDP socket and all resources |
+
+#### Events
+
+| Event | Args | Description |
+|-------|------|-------------|
+| `IsEnabledChanged` | `bool` | Fires when enabled state changes |
+| `ErrorOccurred` | `Exception` | Fires on communication errors |
+| `DataReceived` | `EventArgs` | Fires when a datagram arrives |
+
+---
+
+## 🔧 Configuration
+
+Use `UdpLinkSettings` for structured configuration:
+
+```csharp
+// With explicit local port
+var settings = new UdpLinkSettings("10.0.0.1", remotePort: 8080, localPort: 8081);
+
+// With dynamic local port (default 0)
+var settings = new UdpLinkSettings("10.0.0.1", remotePort: 8080);
+```
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Address` | `string` | Remote host address |
+| `RemotePort` | `int` | Remote port to send to |
+| `LocalPort` | `int` | Local port to bind (0 = OS-assigned) |
+
+---
+
+## 🏗️ Architecture
+
+```
+┌────────────────────────────────────────────┐
+│              AsyncUdpLink                  │
+│                                            │
+│  ┌──────────────┐    ┌──────────────────┐  │
+│  │  Send (Async) │    │ Receive (Async)  │  │
+│  │ → Remote:Port │    │ ← Local:Port     │  │
+│  └──────┬───────┘    └────────┬─────────┘  │
+│         │                     │            │
+│         ▼                     ▼            │
+│  ┌──────────────────────────────────────┐  │
+│  │     Thread-Safe Message Queue        │  │
+│  │          (FIFO, max 100)             │  │
+│  └──────────────────────────────────────┘  │
+│         │                                  │
+│         ▼                                  │
+│  ┌──────────────────────────────────────┐  │
+│  │   Event Dispatch (Data / Error)      │  │
+│  └──────────────────────────────────────┘  │
+└────────────────────────────────────────────┘
+```
+
+---
+
+## 💡 TCP vs UDP — When to Use This Package
+
+| Scenario | Use |
+|----------|-----|
+| Reliable, ordered data transfer | `ThreeByte.LinkLib.TcpLink` |
+| Low-latency, fire-and-forget messaging | **`ThreeByte.LinkLib.UdpLink`** ✅ |
+| Broadcast / multicast discovery | **`ThreeByte.LinkLib.UdpLink`** ✅ |
+| Streaming sensor data | **`ThreeByte.LinkLib.UdpLink`** ✅ |
+| Command-response protocols | `ThreeByte.LinkLib.TcpLink` |
+
+---
+
+## 🎯 Platform Support
+
+| Platform | Supported |
+|----------|-----------|
+| .NET 10.0 | ✅ |
+| .NET Standard 2.1 | ✅ |
+| .NET Standard 2.0 | ✅ |
+| Windows | ✅ |
+| Linux | ✅ |
+| macOS | ✅ |
+
+---
+
+## 📄 License
+
+Part of the [ThreeByte.LinkLib](https://github.com/Three-Byte/three-byte.link-lib) family of communication libraries.
diff --git a/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/ThreeByte.LinkLib.UdpLink.csproj b/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/ThreeByte.LinkLib.UdpLink.csproj
index 9354acf..7a5b99b 100644
--- a/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/ThreeByte.LinkLib.UdpLink.csproj
+++ b/ThreeByte.LinkLib/ThreeByte.LinkLib.UdpLink/ThreeByte.LinkLib.UdpLink.csproj
@@ -4,8 +4,13 @@
   <TargetFrameworks>net10.0;netstandard2.0;netstandard2.1</TargetFrameworks>
   <Nullable>enable</Nullable>
   <LangVersion>latest</LangVersion>
+  <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\ThreeByte.LinkLib.Shared\ThreeByte.LinkLib.Shared.csproj" />
   </ItemGroup>