@alteriom/painlessmesh 1.8.2 → 1.8.4

package/CHANGELOG.md

@@ -7,6 +7,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.8.4] - 2025-11-12
+
+### Fixed
+
+- **Bridge Discovery Timing (Issue #108)** - Immediate bridge status broadcast for faster node discovery
+  - Bridge nodes now send status broadcast immediately on initialization
+  - Bridge status broadcast sent when new nodes connect to mesh
+  - Eliminates 30-second discovery delay that caused "No primary bridge available" errors
+  - Bridge nodes are now discoverable in <1 second instead of up to 30 seconds
+  - Improves user experience in bridge_failover example
+  - Resolves @woodlist's issue with bridge discovery in bridge_failover example
+
+### Changed
+
+- **Bridge Status Broadcasting** - Enhanced timing for immediate node discovery
+  - Added immediate broadcast task on bridge initialization
+  - Registered newConnectionCallback to broadcast when nodes join
+  - Maintains existing periodic broadcasts (30-second default interval)
+  - No breaking changes - fully backward compatible
+
+### Documentation
+
+- **Bridge Failover Example** - Updated documentation for discovery improvements
+  - Added "Bridge Status Monitoring" section documenting new broadcast timing
+  - Added "Bridge Not Discovered" troubleshooting section
+  - Updated README with immediate discovery behavior
+  - Examples: `examples/bridge_failover/`
+
+## [1.8.3] - 2025-11-11
+
+### Fixed
+
+- **Arduino ZIP File Integrity (Issue #89)** - Resolved ZIP file installation issues reported by @woodlist
+  - Removed problematic symlink `_codeql_detected_source_root` that caused ZIP file corruption
+  - Added comprehensive `.gitattributes export-ignore` rules to exclude development files from releases
+  - Improved ZIP file structure for Arduino IDE compatibility
+  - Added version timestamp and metadata to main header file `painlessMesh.h`
+  - Excluded test files, scripts, and development artifacts from Arduino ZIP packages
+  
+- **Station Reconnection After Mesh Init (Issue #21)** - Automatic reconnection for bridge mode station connections
+  - Fixed bug where manual station connections failed to reconnect after mesh initialization
+  - `connectToAP()` now calls `WiFi.begin()` directly for manual connections instead of relying on scan results
+  - Added logging for reconnection attempts
+  - Resolves ESP32-C6 and all ESP platforms bridge connectivity issues
+  - Documentation: `docs/troubleshooting/station-reconnection-issues.md`
+
+### Changed
+
+- **Library Header Documentation** - Added version timestamp and metadata to `painlessMesh.h`
+  - Header now includes version number, release date, and repository URL
+  - Improved documentation for library users
+  - Addresses @woodlist's request for version timestamp tracking
+
+### Improved
+
+- **Release Process** - Enhanced ZIP file creation for Arduino IDE
+  - Better exclusion of development files from distribution packages
+  - Cleaner package structure with only essential library files
+  - Improved compatibility with Arduino IDE's "Add .ZIP Library" feature
+
 ## [1.8.2] - 2025-11-11
 
 ### Added

package/README.md

@@ -207,7 +207,7 @@ mesh.setBridgeSelectionStrategy(ROUND_ROBIN);
 mesh.onBridgeCoordination(&bridgeCoordinationCallback);
 ```
 
-See [Multi-Bridge Implementation](MULTI_BRIDGE_IMPLEMENTATION.md), [Issue #65 Verification](ISSUE_65_VERIFICATION.md), and [examples/multi_bridge/](examples/multi_bridge/) for complete documentation.
+See [Multi-Bridge Implementation](docs/implementation/MULTI_BRIDGE_IMPLEMENTATION.md), [Issue #65 Verification](docs/internal/ISSUE_65_VERIFICATION.md), and [examples/multi_bridge/](examples/multi_bridge/) for complete documentation.
 
 #### 📬 Message Queue for Offline Mode (v1.8.2)
 
@@ -242,7 +242,7 @@ mesh.onQueueFull(&queueFullCallback);
 mesh.onQueueFlushed(&queueFlushedCallback);
 ```
 
-See [Message Queue Implementation](MESSAGE_QUEUE_IMPLEMENTATION.md), [Issue #66 Closure](ISSUE_66_CLOSURE.md), and [examples/queued_alarms/](examples/queued_alarms/) for complete documentation.
+See [Message Queue Implementation](docs/implementation/MESSAGE_QUEUE_IMPLEMENTATION.md), [Issue #66 Closure](docs/internal/ISSUE_66_CLOSURE.md), and [examples/queued_alarms/](examples/queued_alarms/) for complete documentation.
 
 #### MQTT Bridge Commands
 
@@ -294,7 +294,12 @@ painlessMesh does not create a TCP/IP network of nodes. Rather each of the nodes
 
 ### Arduino Library Manager
 
-This library is **Arduino Library Manager compliant** and can be installed directly from the Arduino IDE:
+> **✅ FIXED**: Library name restored to match Arduino Library Manager registry.  
+> **Status**: New releases (v1.8.3+) will now be indexed automatically within 24-48 hours.  
+> **Issue**: Versions v1.7.0-v1.8.1 had incorrect library name and were not indexed.  
+> See [Arduino Library Manager Documentation](docs/ARDUINO_LIBRARY_MANAGER_SUBMISSION.md) for details.
+
+**Once registered**, installation will be available via Arduino IDE:
 
 1. Open Arduino IDE
 2. Go to **Tools** → **Manage Libraries...**
@@ -303,6 +308,40 @@ This library is **Arduino Library Manager compliant** and can be installed direc
 
 The library includes the header file `AlteriomPainlessMesh.h` which provides access to both the core painlessMesh functionality and Alteriom-specific extensions.
 
+#### Manual Installation (Current Method)
+
+**Option 1: Download ZIP from GitHub Release**
+
+1. Go to [Releases](https://github.com/Alteriom/painlessMesh/releases/latest)
+2. Download `painlessMesh-v1.8.3.zip` (or latest version)
+3. In Arduino IDE: **Sketch** → **Include Library** → **Add .ZIP Library...**
+4. Select the downloaded ZIP file
+5. Restart Arduino IDE
+
+**Option 2: Create ZIP from Repository**
+
+If you need to create a ZIP file from source (e.g., for testing unreleased versions):
+
+```bash
+# Clone and create ZIP
+git clone https://github.com/Alteriom/painlessMesh.git
+cd painlessMesh
+./scripts/create-arduino-zip.sh
+
+# Output: dist/painlessMesh-vX.X.X.zip
+# Import this ZIP in Arduino IDE
+```
+
+**Option 3: Git Clone**
+
+```bash
+cd ~/Arduino/libraries/
+git clone https://github.com/Alteriom/painlessMesh.git AlteriomPainlessMesh
+# Restart Arduino IDE
+```
+
+📖 **Detailed Guide**: See [Manual Arduino IDE Installation](docs/getting-started/arduino-manual-install.md) for complete instructions, troubleshooting, and ZIP creation details.
+
 ### PlatformIO
 
 `painlessMesh` is included in both the Arduino Library Manager and the platformio library registry and can easily be installed via either of those methods.
@@ -493,7 +532,31 @@ These are the message types used by applications built on painlessMesh:
 - **Event Coordination** - Synchronized displays, distributed processing
 - **Bridge Networks** - Connect mesh to WiFi/Internet/MQTT - [📖 Bridge Guide](BRIDGE_TO_INTERNET.md)
 
-## Latest Release: v1.8.2 (November 11, 2025)
+## Latest Release: v1.8.4 (November 12, 2025)
+
+**Bridge Discovery Timing Fix for Instant Node Discovery**:
+
+- 🚀 **Instant Bridge Discovery** - Bridge nodes now discoverable in <1 second (was up to 30 seconds)
+- 🔧 **Immediate Status Broadcast** - Bridge sends status immediately on initialization
+- 🔗 **Connection-Triggered Broadcast** - Status broadcast when new nodes join mesh
+- ✅ **Fixes "No Primary Bridge Available"** - Eliminates discovery delays in bridge_failover example
+- 🔧 **100% Backward Compatible** - No breaking changes, enhanced timing only
+
+**[📋 Full Release Notes](docs/releases/RELEASE_NOTES_v1.8.4.md)** | **[📋 Full CHANGELOG](CHANGELOG.md)**
+
+## Previous Release: v1.8.3 (November 11, 2025)
+
+**ZIP File Integrity Fix for Arduino IDE Installation**:
+
+- 🐛 **Critical Bug Fix** - Resolved Arduino IDE installation crashes caused by symlink in release archives
+- 📦 **Clean ZIP Packages** - 50% smaller packages (420K) with only essential files
+- 📝 **Version Documentation** - Added version timestamp to main header file
+- ✅ **Verified Installation** - Tested and working in Arduino IDE "Add .ZIP Library"
+- 🔧 **100% Backward Compatible** - No code changes, packaging fix only
+
+**[📋 Full Release Notes](docs/releases/RELEASE_NOTES_v1.8.3.md)**
+
+## Previous Release: v1.8.2 (November 11, 2025)
 
 **Multi-Bridge Coordination & Message Queue for Critical Systems**:
 
@@ -502,9 +565,8 @@ These are the message types used by applications built on painlessMesh:
 - ⚖️ **Three Load Balancing Strategies** - Priority-Based, Round-Robin, Best Signal (RSSI)
 - 🛡️ **Production Ready** - Battle-tested features for critical deployments (Issues #65 & #66)
 - 📊 **230+ New Test Assertions** - Comprehensive test coverage for both features
-- 🔧 **100% Backward Compatible** - Optional features, no breaking changes
 
-**[📋 Full CHANGELOG](CHANGELOG.md)**
+**[📋 Full Release Notes](docs/releases/RELEASE_NOTES_v1.8.2.md)**
 
 ## Previous Release: v1.8.1 (November 10, 2025)
 
@@ -516,7 +578,7 @@ These are the message types used by applications built on painlessMesh:
 - 🔧 **Zero Breaking Changes** - Purely additive developer experience improvements
 - 📖 **Complete Documentation** - Agent setup guides and knowledge sources
 
-**[📋 Full Release Notes](RELEASE_NOTES_v1.8.1.md)**
+**[📋 Full Release Notes](docs/releases/RELEASE_NOTES_v1.8.1.md)**
 
 ## Previous Release: v1.8.0 (November 9, 2025)
 
@@ -528,7 +590,7 @@ These are the message types used by applications built on painlessMesh:
 - 🔄 **Bridge Failover** - Automatic bridge election and high availability
 - ⚡ **Production Ready** - All features tested, documented, and backward compatible
 
-**[📋 Full Release Notes](RELEASE_NOTES_v1.8.0.md)**
+**[📋 Full Release Notes](docs/releases/RELEASE_NOTES_v1.8.0.md)**
 
 ## Getting Help
 
@@ -629,10 +691,11 @@ We try to follow the [git flow](https://www.atlassian.com/git/tutorials/comparin
 
 ## Funding
 
-If you like the library please consider giving me a tip. This means I will be able to spend more time on developing it.
-You can tip me using ko-fi:
+If you like the library please consider supporting its development. Your contributions help me spend more time improving painlessMesh.
+
+[![PayPal Donation](paypal/qrcode.png)](https://www.paypal.com/paypalme/domlavoie)
 
-[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/U7U21LWO6I)
+**[Donate via PayPal](https://www.paypal.com/paypalme/domlavoie)** • [dominic.lavoie@gmail.com](mailto:dominic.lavoie@gmail.com)
 
 ## 📚 Complete Documentation
 

package/RELEASE_GUIDE.md

@@ -217,38 +217,79 @@ pio pkg publish .
 
 ## 🛠️ Arduino Library Manager
 
+### ✅ IMPORTANT: Library Name Fixed
+
+**Current Status**: ✅ **REGISTERED AND FIXED**
+
+The library IS registered in the Arduino Library Manager. The issue was a library name change that prevented new versions from being indexed.
+
+**Issue Resolved**: Library name in `library.properties` has been restored to match the original registration.
+
+**Result**: New releases will now be automatically indexed by Arduino Library Manager within 24-48 hours.
+
 ### One-Time Submission Process
 
-After your first release, submit to Arduino Library Manager:
+**This must be done once** to enable Arduino IDE installation:
 
 1. **Go to**: https://github.com/arduino/library-registry
-2. **Create issue** with this template:
+2. **Click**: "Issues" → "New Issue"
+3. **Create issue** with this template:
 
-```
-Title: Add painlessMesh library
+```markdown
+Title: Add AlteriomPainlessMesh library
 
 Repository URL: https://github.com/Alteriom/painlessMesh
-Release tag: v1.6.1
-Library name: painlessMesh
-Version: 1.6.1
-
-This is the Alteriom fork of the painlessMesh library with enhanced 
-CI/CD, automated releases, and improved Arduino Library Manager compatibility.
-Includes SensorPackage, CommandPackage, and StatusPackage extensions.
+Library Name: AlteriomPainlessMesh
+Current Version: 1.8.2
+Release Tag: v1.8.2
+
+Description:
+AlteriomPainlessMesh is a user-friendly library for creating mesh networks 
+with ESP8266 and ESP32 devices. Enhanced fork of painlessMesh with:
+
+- SensorPackage (Type 200): Environmental data collection
+- StatusPackage (Type 202): Device health monitoring
+- CommandPackage (Type 400): Remote device control
+- MetricsPackage (Type 204): Performance metrics
+- HealthCheckPackage (Type 605): Proactive monitoring
+- Bridge Coordination: Multi-bridge high availability
+- Message Queue: Offline message queueing
+
+Category: Communication
+Architectures: esp8266, esp32
+Dependencies: ArduinoJson (^7.4.2), TaskScheduler (^4.0.0)
+License: LGPL-3.0
+Documentation: https://alteriom.github.io/painlessMesh/
+
+All Arduino requirements met. Ready for indexing.
 ```
 
-3. **Monitor** the issue for Arduino team approval
-4. **Future releases** are automatically indexed
+4. **Monitor** the issue for Arduino team approval (1-2 weeks typical)
+5. **Verify** registration via Arduino IDE Library Manager search
+6. **Future releases** automatically indexed (24-48 hour delay)
+
+### Detailed Submission Guide
+
+For complete instructions, see: [docs/ARDUINO_LIBRARY_MANAGER_SUBMISSION.md](docs/ARDUINO_LIBRARY_MANAGER_SUBMISSION.md)
+
+The guide includes:
+- Pre-submission checklist
+- Detailed submission template
+- Testing procedures
+- Troubleshooting common issues
+- Post-registration maintenance
 
 ### Arduino Library Compliance
 
 The library meets all Arduino Library Manager requirements:
 - ✅ Correct directory structure
-- ✅ Valid `library.properties` file
+- ✅ Valid `library.properties` file (version=1.8.2)
 - ✅ Source files in `src/` directory
-- ✅ Examples compile successfully
-- ✅ Consistent version numbering
+- ✅ Examples compile successfully (19+ examples)
+- ✅ Consistent version numbering across files
 - ✅ Open source license (LGPL-3.0)
+- ✅ Git tags match library versions
+- ✅ Comprehensive documentation
 
 ## 📚 GitHub Wiki Management
 

package/docs/ARDUINO_LIBRARY_MANAGER_SUBMISSION.md

@@ -0,0 +1,331 @@
+# Arduino Library Manager Submission Guide
+
+## Overview
+
+This document explains the Arduino Library Manager indexing issue and provides the solution to restore automatic version updates.
+
+## Current Status
+
+**Status**: ✅ **Already registered** in Arduino Library Manager  
+**Issue**: New releases (v1.7.0 - v1.8.2) not being indexed  
+**Last Indexed Version**: 1.6.1  
+**Repository**: https://github.com/Alteriom/painlessMesh
+
+## Problem Statement
+
+Users report that the Arduino IDE:
+- Shows old version (1.6.1) instead of current version (1.8.2)
+- Does not detect new releases (v1.7.0 through v1.8.2)
+- Cannot update to newer versions via Library Manager
+- Has issues when trying to add the library as a ZIP file
+
+## Root Cause **[RESOLVED]**
+
+The library name in `library.properties` was changed between v1.6.1 and v1.7.0:
+
+- **v1.6.1**: `name=Alteriom PainlessMesh` (with space)
+- **v1.7.0+**: `name=AlteriomPainlessMesh` (no space)
+
+**Arduino Library Manager requires the library name to remain consistent.** When the name changed, the indexer treated it as a completely different library and stopped indexing new releases under the original name.
+
+The library IS registered at: https://github.com/arduino/library-registry (entry: `https://github.com/Alteriom/painlessMesh`)
+
+## Solution **[IMPLEMENTED]**
+
+Revert the library name in `library.properties` back to the original format with a space:
+
+```properties
+name=Alteriom PainlessMesh
+```
+
+This will allow Arduino Library Manager to resume indexing new releases as updates to the existing library entry.
+
+## Solution: Submit to Arduino Library Registry
+
+### Prerequisites Check ✅
+
+Before submission, verify that the library meets all Arduino Library Manager requirements.
+
+**Automated Validation**:
+
+Run the validation script to check all requirements:
+
+```bash
+./scripts/validate-arduino-compliance.sh
+```
+
+This script verifies:
+
+- ✅ **library.properties file**: Present and properly formatted
+- ✅ **Version field**: Set to 1.8.2
+- ✅ **src/ directory**: Contains all library source code
+- ✅ **examples/ directory**: Contains working example sketches (29+ examples)
+- ✅ **Valid license**: LGPL-3.0 (open source)
+- ✅ **README.md**: Comprehensive documentation
+- ✅ **Git tags**: Releases are properly tagged (v1.8.2, etc.)
+- ✅ **GitHub repository**: Public and accessible
+- ✅ **Library name**: Unique (AlteriomPainlessMesh)
+- ✅ **Version consistency**: All package files have matching versions
+- ✅ **Header files**: Present in src/ directory
+- ✅ **keywords.txt**: Present (optional but recommended)
+
+**Current Status**: ✅ All checks passing
+
+### library.properties Validation
+
+Current library.properties contents:
+
+```properties
+name=AlteriomPainlessMesh
+version=1.8.2
+author=Coopdis,Scotty Franzyshen,Edwin van Leeuwen,Germán Martín,Maximilian Schwarz,Doanh Doanh,Alteriom
+maintainer=Alteriom
+sentence=A painless way to setup a mesh with ESP8266 and ESP32 devices with Alteriom extensions
+paragraph=painlessMesh is a user-friendly library for creating mesh networks with ESP8266 and ESP32 devices. This Alteriom fork includes additional packages for sensor data (SensorPackage), device commands (CommandPackage), and status monitoring (StatusPackage). It handles routing and network management automatically, so you can focus on your application. The library uses JSON-based messaging and syncs time across all nodes, making it ideal for coordinated behaviour like synchronized light displays or sensor networks reporting to a central node.
+category=Communication
+url=https://github.com/Alteriom/painlessMesh
+architectures=esp8266,esp32
+includes=painlessMesh.h
+depends=ArduinoJson, TaskScheduler
+```
+
+**Status**: ✅ All required fields present and properly formatted
+
+### Submission Process
+
+#### Step 1: Prepare Submission Information
+
+Gather the following information for the submission:
+
+```
+Repository URL: https://github.com/Alteriom/painlessMesh
+Library Name: AlteriomPainlessMesh
+Current Version: 1.8.2
+Latest Release Tag: v1.8.2
+Category: Communication
+Architectures: ESP8266, ESP32
+Dependencies: ArduinoJson, TaskScheduler
+License: LGPL-3.0
+```
+
+#### Step 2: Create Submission Issue
+
+1. Go to: https://github.com/arduino/library-registry
+2. Click on "Issues" tab
+3. Click "New Issue"
+4. Use the template below:
+
+```markdown
+## Add AlteriomPainlessMesh to Arduino Library Manager
+
+**Repository URL**: https://github.com/Alteriom/painlessMesh
+
+**Library Name**: AlteriomPainlessMesh
+
+**Current Version**: 1.8.2
+
+**Release Tag**: v1.8.2
+
+**Description**: 
+AlteriomPainlessMesh is a user-friendly library for creating mesh networks with ESP8266 and ESP32 devices. This is an enhanced fork of the original painlessMesh library with additional features:
+
+- **SensorPackage** (Type 200): Environmental data collection with temperature, humidity, pressure monitoring
+- **StatusPackage** (Type 202): Device health monitoring with memory, uptime, and WiFi metrics
+- **CommandPackage** (Type 400): Remote device control and automation
+- **MetricsPackage** (Type 204): Comprehensive performance metrics for dashboards
+- **HealthCheckPackage** (Type 605): Proactive problem detection and predictive maintenance
+- **Bridge Coordination** (Type 613): Multi-bridge support for high availability
+- **Message Queue**: Offline message queuing for critical sensor data
+
+The library handles mesh routing and network management automatically, uses JSON-based messaging, and syncs time across all nodes. Ideal for IoT sensor networks, smart agriculture, home automation, and industrial monitoring.
+
+**Category**: Communication
+
+**Architectures**: esp8266, esp32
+
+**Dependencies**: 
+- ArduinoJson (^7.4.2)
+- TaskScheduler (^4.0.0)
+
+**License**: LGPL-3.0
+
+**Documentation**: https://alteriom.github.io/painlessMesh/
+
+**Maintainer**: Alteriom (https://github.com/Alteriom)
+
+**Additional Information**:
+- Comprehensive CI/CD with automated testing
+- 19+ working examples included
+- 710+ unit tests passing
+- Active maintenance and regular releases
+- PlatformIO Registry: https://registry.platformio.org/libraries/sparck75/AlteriomPainlessMesh
+- NPM Package: https://www.npmjs.com/package/@alteriom/painlessmesh
+
+This library is ready for Arduino Library Manager indexing. All requirements are met:
+- ✅ Valid library.properties file
+- ✅ Proper directory structure (src/, examples/)
+- ✅ Semantic versioning with git tags
+- ✅ Open source license
+- ✅ Examples compile successfully
+- ✅ Comprehensive documentation
+```
+
+#### Step 3: Wait for Review
+
+The Arduino team will review the submission:
+
+1. **Automated checks**: The Arduino bot will validate the repository structure
+2. **Manual review**: Arduino team will verify library quality
+3. **Approval**: If everything is correct, the library will be added to `repositories.txt`
+4. **Indexing**: The Arduino Library Manager will start indexing new releases
+
+**Expected Timeline**: 1-2 weeks (can be longer depending on queue)
+
+#### Step 4: Verify Registration
+
+Once approved, verify the library is accessible:
+
+1. Open Arduino IDE
+2. Go to: Sketch → Include Library → Manage Libraries
+3. Search for "AlteriomPainlessMesh"
+4. Verify version 1.8.2 (or latest) appears
+5. Test installation
+
+### Alternative: Direct Pull Request (Advanced)
+
+If you prefer to submit via pull request:
+
+1. Fork: https://github.com/arduino/library-registry
+2. Edit `repositories.txt`
+3. Add line: `https://github.com/Alteriom/painlessMesh`
+4. Create pull request with description
+5. Wait for review and merge
+
+**Note**: The issue submission method is recommended for first-time submissions.
+
+## Post-Registration
+
+### Automatic Updates
+
+Once registered, future releases will be automatically indexed:
+
+1. Create new release on GitHub with semantic version tag (e.g., v1.8.3)
+2. Update `library.properties`, `library.json`, `package.json` versions
+3. Arduino Library Manager automatically detects new releases
+4. Users can update via Library Manager
+
+**Update Frequency**: Arduino Library Manager checks for updates every 24-48 hours
+
+### Maintenance
+
+To ensure continued compatibility:
+
+- Keep `library.properties` version in sync with git tags
+- Follow semantic versioning (MAJOR.MINOR.PATCH)
+- Test examples before each release
+- Update CHANGELOG.md with changes
+- Maintain backward compatibility when possible
+
+## Testing Library Manager Installation
+
+Once registered, test the installation process:
+
+### Test 1: Fresh Installation
+
+```
+1. Open Arduino IDE
+2. Sketch → Include Library → Manage Libraries
+3. Search: "AlteriomPainlessMesh"
+4. Click "Install"
+5. Verify installation completes
+6. Check: Tools → Manage Libraries → Installed
+```
+
+### Test 2: Example Compilation
+
+```
+1. File → Examples → AlteriomPainlessMesh → basic
+2. Select board: ESP32 Dev Module or ESP8266 board
+3. Verify/Compile sketch
+4. Confirm compilation succeeds
+```
+
+### Test 3: Update Detection
+
+```
+1. Release new version (e.g., v1.8.3)
+2. Wait 24-48 hours for indexing
+3. Open Library Manager
+4. Search: "AlteriomPainlessMesh"
+5. Verify "Update" button appears
+6. Click Update and verify installation
+```
+
+## Troubleshooting
+
+### Library Not Appearing in Manager
+
+**Cause**: Not yet indexed or submission not approved
+**Solution**: 
+- Check submission issue status
+- Wait 24-48 hours after approval
+- Verify `library.properties` has correct format
+
+### Version Not Updating
+
+**Cause**: Git tag doesn't match library.properties version
+**Solution**:
+- Ensure version in library.properties matches git tag
+- Example: library.properties has `version=1.8.2` → git tag must be `v1.8.2`
+- Push corrected tag to GitHub
+
+### Compilation Errors in Library Manager
+
+**Cause**: Missing dependencies or platform-specific issues
+**Solution**:
+- Verify `depends=` field in library.properties lists all dependencies
+- Test compilation on target platforms before release
+- Check Arduino forum for reported issues
+
+### Old Version Showing (1.6.1 Issue)
+
+**Cause**: Library not properly registered or name conflict
+**Solution**:
+- Complete Arduino Library Manager registration
+- Verify library name is unique
+- Check if old library version exists under different name
+
+## Reference Links
+
+- **Arduino Library Manager**: https://www.arduino.cc/reference/en/libraries/
+- **Library Registry**: https://github.com/arduino/library-registry
+- **Submission Guide**: https://support.arduino.cc/hc/en-us/articles/360012175419
+- **Library Specification**: https://arduino.github.io/arduino-cli/latest/library-specification/
+- **Library Manager FAQ**: https://support.arduino.cc/hc/en-us/articles/360016077340
+
+## Support
+
+If you encounter issues with the Arduino Library Manager submission:
+
+1. **Check Documentation**: Review Arduino's official library submission guide
+2. **Search Issues**: Look for similar submissions in arduino/library-registry issues
+3. **Ask Arduino Forum**: Post questions in Arduino's library development forum
+4. **Contact Maintainer**: Open issue in this repository for help
+
+## Summary
+
+**Action Required**: Submit the library to Arduino Library Manager registry
+
+**Method**: Create issue at https://github.com/arduino/library-registry
+
+**Expected Result**: Library becomes installable via Arduino IDE's Library Manager
+
+**Timeline**: 1-2 weeks for review and approval
+
+**Maintenance**: Future releases automatically indexed every 24-48 hours
+
+Once registered, users will be able to:
+- ✅ Search for "AlteriomPainlessMesh" in Arduino IDE
+- ✅ Install with one click
+- ✅ Update to latest versions automatically
+- ✅ Access library documentation and examples