+
+
+
+
_Dynamic icons adapt to price levels, trends, and period states - showing CHEAP prices, FALLING trend, and active Best Price Period_
-π **[Dynamic Icons Guide β](docs/user/dynamic-icons.md)** | **[Icon Colors Guide β](docs/user/icon-colors.md)**
+π **[Dynamic Icons Guide β](https://jpawlowski.github.io/hass.tibber_prices/user/dynamic-icons)** | **[Icon Colors Guide β](https://jpawlowski.github.io/hass.tibber_prices/user/icon-colors)**
### Custom Actions
@@ -328,27 +342,27 @@ The integration provides custom actions (they still appear as services under the
- `tibber_prices.get_apexcharts_yaml` - Generate complete ApexCharts configurations
- `tibber_prices.refresh_user_data` - Manually refresh account information
-π **[Action documentation and examples β](docs/user/actions.md)**
+π **[Action documentation and examples β](https://jpawlowski.github.io/hass.tibber_prices/user/actions)**
### Chart Visualizations (Optional)
The integration includes built-in support for creating price visualization cards with automatic Y-axis scaling and color-coded series.
-
+
_Optional: Dynamic 48h chart with automatic Y-axis scaling - generated via `get_apexcharts_yaml` action_
-π **[Chart examples and setup guide β](docs/user/chart-examples.md)**
+π **[Chart examples and setup guide β](https://jpawlowski.github.io/hass.tibber_prices/user/chart-examples)**
## π€ Contributing
-Contributions are welcome! Please read the [Contributing Guidelines](CONTRIBUTING.md) and [Developer Guide](docs/development/) before submitting pull requests.
+Contributions are welcome! Please read the [Contributing Guidelines](CONTRIBUTING.md) and [Developer Documentation](https://jpawlowski.github.io/hass.tibber_prices/developer/) before submitting pull requests.
### For Contributors
-- **[Developer Setup](docs/development/setup.md)** - Get started with DevContainer
-- **[Architecture Guide](docs/development/architecture.md)** - Understand the codebase
-- **[Release Management](docs/development/release-management.md)** - Release process and versioning
+- **[Developer Setup](https://jpawlowski.github.io/hass.tibber_prices/developer/setup)** - Get started with DevContainer
+- **[Architecture Guide](https://jpawlowski.github.io/hass.tibber_prices/developer/architecture)** - Understand the codebase
+- **[Release Management](https://jpawlowski.github.io/hass.tibber_prices/developer/release-management)** - Release process and versioning
## π€ Development Note
diff --git a/docs/cleanup-old-versions.sh b/docs/cleanup-old-versions.sh
new file mode 100755
index 0000000..c8730bc
--- /dev/null
+++ b/docs/cleanup-old-versions.sh
@@ -0,0 +1,128 @@
+#!/bin/bash
+set -e
+
+# Cleanup old documentation versions based on versioning strategy:
+# - Pre-1.0 (0.x.y): Keep only last 5 versions
+# - Post-1.0 (β₯1.0.0): Keep last 3 MINOR versions per MAJOR (only latest PATCH per MINOR)
+
+KEEP_PRE_1_0=5
+KEEP_POST_1_0_MINORS=3
+
+echo "π§Ή Cleaning up old documentation versions..."
+
+for doc_type in "user" "developer"; do
+ VERSIONS_FILE="${doc_type}_versions.json"
+ VERSIONED_DOCS_DIR="${doc_type}_versioned_docs"
+
+ if [ ! -f "$VERSIONS_FILE" ]; then
+ echo "β οΈ No $VERSIONS_FILE found, skipping $doc_type docs"
+ continue
+ fi
+
+ # Read current versions from JSON (remove brackets and quotes)
+ CURRENT_VERSIONS=$(jq -r '.[]' "$VERSIONS_FILE" 2>/dev/null || echo "")
+
+ if [ -z "$CURRENT_VERSIONS" ]; then
+ echo "β No versions found in $VERSIONS_FILE"
+ continue
+ fi
+
+ echo ""
+ echo "π Current $doc_type versions:"
+ echo "$CURRENT_VERSIONS"
+
+ # Separate pre-1.0 and post-1.0 versions
+ PRE_1_0_VERSIONS=$(echo "$CURRENT_VERSIONS" | grep '^v0\.' || true)
+ POST_1_0_VERSIONS=$(echo "$CURRENT_VERSIONS" | grep -v '^v0\.' || true)
+
+ VERSIONS_TO_KEEP=()
+
+ # Handle pre-1.0 versions: keep last N
+ if [ -n "$PRE_1_0_VERSIONS" ]; then
+ echo ""
+ echo "π Processing pre-1.0 versions (keep last $KEEP_PRE_1_0):"
+ PRE_1_0_SORTED=$(echo "$PRE_1_0_VERSIONS" | sort -V -r)
+ PRE_1_0_KEEP=$(echo "$PRE_1_0_SORTED" | head -n "$KEEP_PRE_1_0")
+
+ while IFS= read -r version; do
+ [ -n "$version" ] && VERSIONS_TO_KEEP+=("$version")
+ done <<< "$PRE_1_0_KEEP"
+
+ echo "$PRE_1_0_KEEP"
+ fi
+
+ # Handle post-1.0 versions: keep last N MINOR per MAJOR (latest PATCH only)
+ if [ -n "$POST_1_0_VERSIONS" ]; then
+ echo ""
+ echo "π Processing post-1.0 versions (keep last $KEEP_POST_1_0_MINORS MINOR per MAJOR):"
+
+ # Get unique MAJOR versions
+ MAJORS=$(echo "$POST_1_0_VERSIONS" | sed 's/^v\([0-9]*\)\..*/\1/' | sort -u -n)
+
+ for major in $MAJORS; do
+ # Get all versions for this MAJOR
+ MAJOR_VERSIONS=$(echo "$POST_1_0_VERSIONS" | grep "^v${major}\.")
+
+ # Group by MINOR version and keep only latest PATCH
+ MINORS=$(echo "$MAJOR_VERSIONS" | sed 's/^v[0-9]*\.\([0-9]*\)\..*/\1/' | sort -u -n -r)
+
+ MINOR_COUNT=0
+ for minor in $MINORS; do
+ if [ $MINOR_COUNT -ge $KEEP_POST_1_0_MINORS ]; then
+ break
+ fi
+
+ # Get latest PATCH for this MINOR
+ LATEST_PATCH=$(echo "$MAJOR_VERSIONS" | grep "^v${major}\.${minor}\." | sort -V -r | head -n 1)
+
+ if [ -n "$LATEST_PATCH" ]; then
+ VERSIONS_TO_KEEP+=("$LATEST_PATCH")
+ echo " v${major}.${minor}.x β $LATEST_PATCH"
+ MINOR_COUNT=$((MINOR_COUNT + 1))
+ fi
+ done
+ done
+ fi
+
+ # Convert array to newline-separated list for comparison
+ KEEP_LIST=$(printf "%s\n" "${VERSIONS_TO_KEEP[@]}" | sort -V)
+
+ echo ""
+ echo "β
Versions to keep for $doc_type:"
+ echo "$KEEP_LIST"
+
+ # Find versions to delete
+ VERSIONS_TO_DELETE=()
+ while IFS= read -r version; do
+ if ! echo "$KEEP_LIST" | grep -q "^${version}$"; then
+ VERSIONS_TO_DELETE+=("$version")
+ fi
+ done <<< "$CURRENT_VERSIONS"
+
+ if [ ${#VERSIONS_TO_DELETE[@]} -eq 0 ]; then
+ echo ""
+ echo "β No old versions to delete for $doc_type"
+ continue
+ fi
+
+ echo ""
+ echo "ποΈ Deleting old $doc_type versions:"
+ for version in "${VERSIONS_TO_DELETE[@]}"; do
+ echo " - $version"
+
+ # Remove versioned docs directory
+ VERSION_DIR="${VERSIONED_DOCS_DIR}/version-${version}"
+ if [ -d "$VERSION_DIR" ]; then
+ rm -rf "$VERSION_DIR"
+ echo " Removed: $VERSION_DIR"
+ fi
+ done
+
+ # Update versions.json with only kept versions
+ echo "$KEEP_LIST" | jq -R -s 'split("\n") | map(select(length > 0))' > "$VERSIONS_FILE"
+ echo ""
+ echo "β Updated $VERSIONS_FILE"
+done
+
+echo ""
+echo "β¨ Cleanup complete!"
diff --git a/docs/developer/.gitignore b/docs/developer/.gitignore
new file mode 100644
index 0000000..b2d6de3
--- /dev/null
+++ b/docs/developer/.gitignore
@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
diff --git a/docs/developer/README.md b/docs/developer/README.md
new file mode 100644
index 0000000..b28211a
--- /dev/null
+++ b/docs/developer/README.md
@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER={siteConfig.tagline}
++ Modular design with separation of concerns. Calculator pattern for business logic, + coordinator-based data flow, and comprehensive caching strategies. +
++ Comprehensive test suite with unit, integration, and E2E tests. Resource leak + detection, lifecycle validation, and performance benchmarks. +
++ Complete API reference, architecture diagrams, coding guidelines, and + debugging guides. Everything you need to contribute effectively. +
++ Pre-configured development environment with all dependencies. VS Code + integration, linting, type checking, and debugging tools included. +
++ Multi-layer caching, optimized algorithms, and efficient data structures. + Coordinator updates in <500ms, sensor updates in <10ms. +
++ Open source project with active development. Conventional commits, + semantic versioning, and automated release management. +
+