Skip to content

docs: add Skylight alternative page, fix FAQ issues #14/#20, and homepage 404s - #38

Merged
asachs01 merged 3 commits into
mainfrom
cursor/lightkeeper-docs-publish-5c8c
Oct 12, 2026
Merged

asachs01 merged 3 commits into
mainfrom
cursor/lightkeeper-docs-publish-5c8c

Conversation

@asachs01

Copy link
Copy Markdown
Owner

Summary

This PR delivers a Lightkeeper-approved docs publish pass with:

  1. New "Beacon vs Skylight" comparison page for SEO/growth
  2. FAQ updates addressing issues Are notifications implemanted ? #14 (notifications) and Kiosk Mode not working as expected #20 (kiosk mode / HA sidebar)
  3. Homepage 404 fixes for broken doc links
  4. robots.txt for improved SEO

Changes

New Content

  • /docs/getting-started/skylight-alternative/ — Comprehensive Beacon vs Skylight comparison page with:
    • Feature/cost comparison table
    • Clear guidance on who should choose which option
    • Quick FAQ addressing common Skylight-alternative questions
    • SEO-friendly content targeting "Skylight alternative" searches

FAQ Updates

  • Issue Are notifications implemanted ? #14 (Notifications): Updated FAQ to clarify that push notifications are not yet shipped, removing misleading "Yes" answer. Closest available feature is screen saver/kid display mode. Invites contributors.
  • Issue Kiosk Mode not working as expected #20 (Kiosk/HA Sidebar): Added new FAQ entry explaining:
    • Beacon cannot hide HA's sidebar when running inside ingress
    • How to use direct add-on URL for full-screen kiosk setups
    • Platform-specific kiosk instructions (Fully Kiosk, Chrome --kiosk, etc.)
    • Cross-references to installation guide

Bug Fixes

  • Homepage 404s: Fixed four broken documentation links in index.astro:
    • /docs/getting-started/ → /docs/getting-started/installation/
    • /docs/calendar/ → /docs/features/calendar/
    • /docs/configuration/ → /docs/customization/configuration/
    • /docs/faq/ → /docs/reference/faq/

SEO Improvements

  • robots.txt: Added proper robots.txt with sitemap reference pointing to Astro's auto-generated sitemap

Testing

Verification Steps

  • New Skylight alternative page renders correctly at /docs/getting-started/skylight-alternative/
  • Page appears in Getting Started sidebar navigation
  • FAQ entries for notifications and kiosk mode are clear and accurate
  • All homepage doc links resolve without 404s
  • robots.txt is accessible at /robots.txt
  • Sitemap reference in robots.txt resolves

Related Issues

Notes

  • Did NOT modify README hero (separate Forge PR as per instructions)
  • Did NOT post to GitHub issues (per instructions)
  • PR is marked as draft for review
  • Stable URL path chosen: /docs/getting-started/skylight-alternative/ (matches existing structure)
  • Content approved by Lightkeeper for SEO/growth targeting
Open in Web Open in Cursor 

cursoragent and others added 3 commits October 12, 2026 16:12
…page 404s

- Add comprehensive Beacon vs Skylight comparison page at /docs/getting-started/skylight-alternative/
- Update FAQ to clarify notifications are not yet shipped (issue #14)
- Add FAQ entry for hiding HA sidebar in kiosk mode (issue #20)
- Fix broken documentation links on homepage (getting-started, calendar, configuration, faq)
- Add robots.txt with sitemap reference for SEO

Signed-off-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: Aaron Sachs <asachs01@users.noreply.github.com>
- Update Getting Started sidebar order per Signal's SEO sequence:
  - Welcome = 1
  - Skylight alternative = 2
  - Installation = 3
  - Visual Walkthrough = 4
  - Deployment = 5
- Convert plain text next steps to proper markdown links on Skylight page
- Fixes unstable sidebar sort caused by duplicate order: 3

Signed-off-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: Aaron Sachs <asachs01@users.noreply.github.com>
- Fix notifications FAQ entry: notifications ARE implemented via useNotifications()
  - Default 10 minutes before events, configurable to 5/10/15/30 in Settings > Calendar
  - Browser push + HA mobile app notifications
  - Only for timed events (not all-day)
- Fix kiosk mode FAQ entry: Kiosk Mode toggle now works (fixed in PR #51)
  - Settings > Display > Kiosk Mode hides Beacon's sidebar entirely
  - Distinguish between Beacon's sidebar and HA's ingress sidebar
- Update notifications.mdx to match: document configurable timing, default 10min
- Resolves contradiction between FAQ and shipped code after three-week staleness

Signed-off-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: Aaron Sachs <asachs01@users.noreply.github.com>
@cursor
cursor Bot force-pushed the cursor/lightkeeper-docs-publish-5c8c branch from 6d224f2 to 6f7dc93 Compare October 12, 2026 16:13
@asachs01
asachs01 marked this pull request as ready for review October 12, 2026 16:15
@asachs01
asachs01 merged commit f270f01 into main Oct 12, 2026
1 check passed
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.39.5 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Kiosk Mode not working as expected Are notifications implemanted ?

2 participants