docusaurus-amplify-fix

Docusaurus sites using trailingSlash false on AWS Amplify return 404s because Amplify expects directory-based index.html files. The skill solves this by copying generated HTML files into trailing-slash friendly index.html paths during the build process.

Run a build script that detects the Docusaurus root by locating docusaurus.config.*, copies .html pages into trailing-slash compatible index.html files, and update amplify.yml to execute the script automatically after each build.

Update amplify.yml to run a post-build script that generates trailing-slash friendly index.html copies of your pages, ensuring both /docs/page.html and /docs/page/ resolve without 404 errors on Amplify hosting.

It works with Docusaurus projects using trailingSlash false and deployed on AWS Amplify hosting. The script automatically detects the Docusaurus root by locating docusaurus.config.* files within the project structure.

Yes, you update amplify.yml build commands to run the fix script after building the site. This automates copying .html pages into trailing-slash friendly index.html files during every deployment pipeline execution.

If 404s persist, verify amplify.yml runs the fix script after the Docusaurus build step. The script must detect the Docusaurus root via docusaurus.config.* and copy HTML files into directory-based index.html paths to resolve the issue.