Skip to content

Conversation

@bhanreddy1973
Copy link

@bhanreddy1973 bhanreddy1973 commented Jan 2, 2026

What has changed?

This PR implements a custom, branded 404 page for the Keploy documentation website as requested in Issue #3441.

Summary of Changes:

  • Custom Pill Header: Added a floating rounded navigation bar with Keploy logo, Technology/Community/Resources links
  • Badge Chips: Included VS Code installs (1.1M) and GitHub stars (14.3K) badges in the header
  • Search Integration: Added search button that triggers DocSearch (Cmd/Ctrl + K)
  • Theme Toggle: Added Dark/Light mode switch button inside the custom 404 header
  • Slack Button: Added a dedicated Slack button inside the custom 404 header
  • Bunny Mascot: Created custom SVG illustration of the Keploy bunny sitting on a wooden log with a warning sign
  • "Oops! 404 Not Found...": Styled error message with Keploy's orange branding (#ff914d)
  • Navigation Buttons: "Back To Home" and "Go Back" (previous page) buttons
  • Global Component Hiding: Implemented logic to hide default Docusaurus navbar and announcement bar on the 404 route
  • Responsive Design: Works seamlessly on mobile and desktop devices

Fixes keploy/keploy#3441

Type of change

  • New feature (non-breaking change which adds functionality).

How Has This Been Tested?

Tested locally using npm start and visiting non-existent URLs like /docs/xyz.

Screenshots:

404 Page (Desktop View):

image image

404 Page (Mobile View):

image image

Build Output:

npm run build

Build completed successfully## Checklist:

  • My code follows the style guidelines of this project.
  • I have performed a self-review of my own code.

Files Changed:

  1. src/theme/NotFound/index.js - Layout wrapper with noNavbar/noFooter props
  2. src/theme/NotFound/Content/index.js - Main 404 page UI and logic (custom header + theme toggle + slack button + illustration)
  3. src/css/custom.css - CSS rules to hide global Docusaurus components

- Implemented custom 404 page with Keploy branding
- Added floating pill header with Technology, Community, and Resources links
- Included VS Code and GitHub badges in the custom header
- Added search button logic to trigger DocSearch
- Created custom SVG illustration of Keploy bunny mascot
- Implemented logic to hide global Docusaurus components on 404 route
- Ensured responsive design for mobile and desktop

Fixes keploy/keploy#3441

Signed-off-by: Bhanu Reddy <[email protected]>
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you and congratulations 🎉 for opening your very first pull request in keploy

Copy link
Member

@Achanandhi-M Achanandhi-M left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bhanreddy1973, we don’t want to make any design changes in the docs header—please focus only on fixing the 404 issue. The redirection should point to /docs/; we don’t want to show any separate page.

Additionally, please include a short video demonstrating your changes and make sure to fix all the failing pipelines.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-website]: add a 404 page in the blog website

3 participants