Troubleshooting
Running into bugs, weird behavior, or “why does this hate me?” moments? This page packs fixes for the most common issues across the platform.
If your issue isn’t listed, scroll down — we’ve got options for community support and direct help.
Most Common Issues
Page Not Loading / White Screen
This usually happens due to missing scripts, invalid JSON files, or an HTML build error.
- Open your browser dev tools → Console → check for errors
- Make sure all local paths begin with
/docs/… - Verify your
docs.jsonfile is valid (no trailing commas!) - Clear cache: CTRL + Shift + R
Search Bar Shows No Results
If your new page isn’t appearing in search:
- Open
docs.jsonand make sure the entry exists - Confirm your
title,path, andtagsfields are correct - Ensure the search script is correctly linked
Styles Not Loading
99% of the time it’s either a missing Tailwind CDN import or an empty PurgeCSS build (if using a pipeline).
- Make sure your Tailwind CDN is loaded at the top of the page
- Check for network errors — maybe GitHub Pages is rate-limiting
- Try loading the page in an incognito tab
GitHub Pages Not Updating
GitHub Pages is slow sometimes.
- Wait 15–60 seconds after pushing
- Force reload with CTRL + Shift + R
- Verify your repo settings → Pages → branch set correctly
- Make sure there’s an
index.htmlin every folder
Need More Help?
If something is still acting cursed, hit one of the options below.