[bug] Broken Documentation Links Leading to "Page Not Found" Screens

[tejas0711]

Which package?

Documentation Website (docs.termui.io)

What happened?

Several documentation links displayed in the sidebar redirect users to a "Page not found" screen instead of loading the expected documentation content.

Examples observed:

• /docs/getting-started/quickstart
• /docs/guides/theming
• /docs/guides/routing
• /docs/motion/overview
• /docs/jsx/overview
• /docs/dev-server/overview

Expected Behavior:
When a user clicks a documentation link from the sidebar, the corresponding documentation page should open successfully.

Actual Behaviour:
The website displays a "Page not found" screen with the message:

"The documentation page doesn't exist yet."
This creates confusion because the pages appear to be available in the navigation menu.

Steps to reproduce

1. Open https://termui.io/docs
2. Navigate using the left sidebar.
3. Click on any of the following pages:
   • Getting Started → Quickstart
   • Guides → Routing
   • Guides → Theming
   • Motion → Overview
   • JSX → Overview
4. Observe the result.

Expected:
Documentation page loads.

Actual:
"Page not found" screen is displayed.

Following are the issues :

[github-actions]

✅ Auto-assigned to @tejas0711 (issue opener).

Open your PR by 2026-07-01 (7 days). The bot frees this issue for another contributor after that date.

Reminders:

• ⭐ Star the repo first. The star-check job blocks your merge otherwise.
• PR title: type: short description
• Link this issue in your PR body: Closes #1811

Good luck. 🚀

[github-actions]

👋 Welcome to TermUI, @tejas0711. Thanks for opening your first issue.

Quick checks:

1. ⭐ Star the repo. Required for GSSoC point credit.
2. 📖 Read CONTRIBUTING.md.
3. 🏷 Use the right issue template.

To claim an issue: comment I would like to work on this. The bot assigns you. You have 7 days to open your PR.

GSSoC 2026 point system: every approved PR earns +50 base plus difficulty, quality, and type bonuses. See gssoc-points.md.

Your reviewer responds within 48 hours.

[tejas0711]

Hello @Karanjot786
I investigated the issue.
The documentation URLs referenced in README files (for example docs/getting-started/quick-start) point to routes that do not appear to exist in the current website implementation.
The website currently contains only a minimal homepage (website/src/main.ts) and I could not find corresponding documentation pages or routing definitions for those URLs.

Could you confirm whether:

1. The docs pages were removed accidentally?
2. The URLs should be updated to different routes?
3. The expected fix is to create the missing documentation pages?

[github-actions]

⏰ Auto-unassigned: no PR opened within 7 days.

@tejas0711, re-claim it by commenting I would like to work on this again.

Other contributors can now pick this up.

[aaniya22]

I would like to work on this

[KrutagyaKaneria]

Hi @Karanjot786 👋

I would like to work on this issue under GSSoC '26.

I reviewed the reported broken documentation routes and understand that the sidebar currently contains links that lead to "Page not found" pages, resulting in a confusing navigation experience.

My implementation plan includes:

• Investigating the documentation routing configuration to identify why the affected sidebar links are unresolved.

• Verifying whether the issue is caused by:

  • Incorrect route definitions
  • Missing documentation pages
  • Broken sidebar/navigation configuration
  • Incorrect file paths or slugs

• Fixing the affected routes so that the following pages resolve correctly:

  • Getting Started → Quickstart
  • Guides → Theming
  • Guides → Routing
  • Motion → Overview
  • JSX → Overview
  • Dev Server → Overview

• Ensuring the sidebar navigation remains consistent and all internal documentation links point to valid pages.

• Verifying that no existing documentation routes or navigation behavior are affected.

Before opening the PR, I will verify:

• All reported documentation links open successfully.
• No sidebar links lead to unexpected 404 pages.
• Documentation navigation and routing work correctly across the affected sections.
• Any new or updated pages follow the existing documentation structure and formatting.

This will improve the documentation experience for contributors and new users by ensuring all visible navigation links lead to valid documentation.

Please assign this issue to me under GSSoC '26. 🚀

[github-actions]

✅ Assigned to @KrutagyaKaneria.

Open your PR by 2026-07-10 (7 days from now). The bot frees this issue for another contributor after that date.

Reminders:

• ⭐ Star the repo first. The star-check job blocks your merge otherwise.
• PR title: type: short description
• Link this issue in your PR body: Closes #1811

Good luck. 🚀

[KrutagyaKaneria]

Hi @Karanjot786 , I investigated this in the main TermUI repository but couldn't find the documentation website source (sidebar/routes/content). The repository only contains internal documentation under docs/. Could you confirm whether this issue should be fixed in a separate documentation repository (for example, the docs website repo)?