From 07950603dc20b227ff6df84124ba2f036f8a2672 Mon Sep 17 00:00:00 2001 From: Elio Neto Date: Mon, 13 Jul 2026 10:59:33 -0300 Subject: [PATCH 1/2] fix(ci): add .nojekyll to prevent GitHub Pages Jekyll build The built-in pages-build-deployment tries to build with Jekyll and fails because the repo has no Jekyll config. Adding .nojekyll at the root tells GitHub Pages to skip Jekyll and serve files as-is. Also adds .nojekyll to the site/ directory in deploy-site.yml as a defense in depth. --- .github/workflows/deploy-site.yml | 1 + .nojekyll | 0 2 files changed, 1 insertion(+) create mode 100644 .nojekyll diff --git a/.github/workflows/deploy-site.yml b/.github/workflows/deploy-site.yml index 3811a76f..ffa6c3cf 100644 --- a/.github/workflows/deploy-site.yml +++ b/.github/workflows/deploy-site.yml @@ -23,6 +23,7 @@ jobs: - name: Prepare site content run: | mkdir -p site/schema + touch site/.nojekyll cp -rL packages/docs/* site/ cp schemas/teamcode.json site/schema/config.json cp schemas/tui.json site/schema/tui.json diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b From 8d5e37b6d22637082df32476d7f72e5797723482 Mon Sep 17 00:00:00 2001 From: Elio Neto Date: Mon, 13 Jul 2026 11:05:12 -0300 Subject: [PATCH 2/2] fix(ci): generate index.html landing page to fix 404 on GitHub Pages GitHub Pages needs an index.html at the root to serve content. The packages/docs/ contains raw .mdx files (Mintlify source format) which aren't served as HTML by GitHub Pages. Generate a simple landing page with links to the schemas and documentation files. Also adds .nojekyll to the site/ directory to prevent the built-in GitHub Pages Jekyll builder from attempting to process the site. --- .github/workflows/deploy-site.yml | 34 +++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/.github/workflows/deploy-site.yml b/.github/workflows/deploy-site.yml index ffa6c3cf..1a630635 100644 --- a/.github/workflows/deploy-site.yml +++ b/.github/workflows/deploy-site.yml @@ -27,6 +27,40 @@ jobs: cp -rL packages/docs/* site/ cp schemas/teamcode.json site/schema/config.json cp schemas/tui.json site/schema/tui.json + + # Generate a landing page — the raw .mdx files are Mintlify-source and + # can't be served as HTML by GitHub Pages. + cat > site/index.html << 'EOF' + + + + teamcode + +

teamcode

+

AI-powered development tool.

+

Schema reference

+ +

Documentation

+ + EOF - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: