update

Author: Vidigal-code

README.md

@@ -169,11 +169,10 @@ npm start
 - Enable Pages for your repository (Settings -> Pages).
 - Use the repository workflow to build/deploy static output.
 - Optional one-command bootstrap:
-  - `npx gitpagedocs --push --owner your-user --repo your-repository` — docs at `https://<owner>.github.io/<repo>/v/<version>/`
+  - `npx gitpagedocs --push --owner your-user --repo your-repository` — docs at `https://<owner>.github.io/<repo>/<repo>/v/<version>/?lang=en` (e.g. `https://vidigal-code.github.io/energy-bill-ai-parser/energy-bill-ai-parser/v/1.0.0/?lang=en`); root redirects there; base path uses repo name so CSS/JS load correctly
   - `npx gitpagedocs --push --owner your-user --repo your-repository --path docs` — docs at `https://<owner>.github.io/<repo>/docs/v/<version>/`
   - This creates `.github/workflows/gitpagedocs-pages.yml`, sets `site.rendering`, commits generated artifacts, and pushes to `origin`.
   - The generated workflow clones the official `git-page-docs` runtime in CI, injects your `gitpagedocs/` folder, builds, and deploys to your GitHub Pages URL.
-  - Root URL redirects to docs entrypoint (`/v/<version>`), so `https://<owner>.github.io/<repo>/` opens docs directly.
   - The workflow trigger uses your current git branch automatically.
   - After push, CLI also attempts to switch repository Pages source to **GitHub Actions** using `gh api` (if GitHub CLI is available and authenticated).
 
@@ -191,7 +190,6 @@ gitpagedocs/
     versions/
       1.0.0/config.json
       1.0.0/{en,pt,es}/*.md
-      1.0.0/{en,pt,es}/getting-started    # HTML (no .html extension)
       1.0.0/{en,pt,es}/source-viewer      # Source code viewer (GitHub-style)
       1.1.0/...
       1.1.1/...
@@ -300,10 +298,8 @@ All routes for accessing documentation files on the official site or self-hosted
 - Project overview:  
   https://vidigal-code.github.io/git-page-docs/Vidigal-code/git-page-docs/v/1.0.0/?lang=en&menu=en&name=project-overview  
 
-**HTML pages** (by slug; pages combine MD + HTML when they share the same route id)
+**HTML pages** (by slug)
 
-- Getting Started (HTML):  
-  https://vidigal-code.github.io/git-page-docs/Vidigal-code/git-page-docs/v/1.0.0/?lang=en&menu=en&name=getting-started  
 - Source code viewer:  
   https://vidigal-code.github.io/git-page-docs/Vidigal-code/git-page-docs/v/1.0.0/?lang=en&menu=en&name=source-viewer  
 
@@ -341,7 +337,7 @@ All routes for accessing documentation files on the official site or self-hosted
 |--------|-------------|
 | `--owner <user>` | GitHub owner (e.g. `Vidigal-code`) |
 | `--repo <repo>` | GitHub repository (e.g. `git-page-docs`) |
-| `--path <subpath>` | Subpath for docs (e.g. `docs`, `git-page-docs`) |
+| `--path <subpath>` | Subpath for docs (e.g. `docs`); without it, base path = repo name for correct asset loading on project sites |
 | `--output <dir>` | Output directory (default: `gitpagedocs` or `gitpagedocshome` with `--home`) |
 | `--search true\|false` | Enable/disable repository search (mainly for `--home`) |
 | `--layoutconfig` | Generate local layout templates in `gitpagedocs/layouts/` |

cli/builders/config-orchestrator.mjs

@@ -2,7 +2,6 @@
 
 import { LAYOUTS, FALLBACK_LAYOUTS } from "../data/layouts.mjs";
 import { DOCS } from "../content/docs.mjs";
-import { HTML_PAGES } from "../content/html-pages.mjs";
 import { DOC_VERSIONS } from "../data/version-constants.mjs";
 import { buildRootConfig } from "./root-config-builder.mjs";
 import { buildVersionConfig } from "./version-config-builder.mjs";
@@ -22,7 +21,6 @@ export function buildConfigArtifacts(options = {}) {
 
   const sourceViewerHtml = generateSourceViewerHtml(root);
   const docsHtml = {
-    ...HTML_PAGES,
     sourceViewer: { pt: sourceViewerHtml, en: sourceViewerHtml, es: sourceViewerHtml },
   };
 

cli/builders/source-viewer.mjs

@@ -1,4 +1,4 @@
-/** Generate GitHub-style source code viewer HTML from src/ and README.md */
+/** Generate GitHub-style source code viewer HTML from src/, cli/, and root config files */
 
 import path from "node:path";
 import { readFileSync, readdirSync, existsSync } from "node:fs";
@@ -19,7 +19,9 @@ function buildTreeFromKeys(fileKeys) {
   return root;
 }
 
-function collectSourceFiles(root) {
+const ROOT_FILES = ["README.md", "package.json", "package-lock.json", "next.config.ts", "tsconfig.json", ".eslintrc.json"];
+
+function collectSourceFiles(projectRoot) {
   const files = {};
   function scan(dir, prefix = "") {
     if (!existsSync(dir)) return;
@@ -33,21 +35,26 @@ function collectSourceFiles(root) {
         scan(fullPath, rel);
       } else {
         try {
-          files[rel] = readFileSync(fullPath, "utf-8");
+          const content = readFileSync(fullPath, "utf-8");
+          files[rel] = content;
         } catch {
-          // skip binary or unreadable files
+          /* skip binary or unreadable */
         }
       }
     }
   }
-  const readmePath = path.join(root, "README.md");
-  if (existsSync(readmePath)) {
-    try {
-      files["README.md"] = readFileSync(readmePath, "utf-8");
-    } catch {}
+  for (const f of ROOT_FILES) {
+    const p = path.join(projectRoot, f);
+    if (existsSync(p)) {
+      try {
+        files[f] = readFileSync(p, "utf-8");
+      } catch {}
+    }
   }
-  const srcDir = path.join(root, "src");
-  scan(srcDir, "src");
+  const srcDir = path.join(projectRoot, "src");
+  const cliDir = path.join(projectRoot, "cli");
+  if (existsSync(srcDir)) scan(srcDir, "src");
+  if (existsSync(cliDir)) scan(cliDir, "cli");
   return files;
 }
 
@@ -112,6 +119,13 @@ body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,san
 .sidebar .folder.collapsed .chevron{transform:rotate(-90deg)}
 .sidebar .children{margin-left:4px}
 .sidebar .children.hidden{display:none}
+.sidebar .search-wrap{padding:8px;border-bottom:1px solid var(--github-border-muted)}
+.sidebar .search-input{width:100%;padding:6px 10px;font-size:12px;border:1px solid var(--github-border);border-radius:6px;background:var(--github-bg);color:var(--github-fg);outline:none}
+.sidebar .search-input:focus{border-color:var(--github-accent)}
+.sidebar .search-input::placeholder{color:var(--github-fg-muted)}
+.sidebar .tree-actions{display:flex;gap:4px;padding:4px 8px;border-bottom:1px solid var(--github-border-muted)}
+.sidebar .tree-btn{padding:4px 8px;font-size:11px;border:1px solid var(--github-border);border-radius:4px;background:var(--github-bg-tertiary);color:var(--github-fg-muted);cursor:pointer}
+.sidebar .tree-btn:hover{color:var(--github-fg);background:var(--github-border)}
 
 /* Content - GitHub file view */
 .content{flex:1;display:flex;flex-direction:column;overflow:hidden;background:var(--github-bg)}
@@ -150,7 +164,11 @@ body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,san
   <span class="file-name" id="breadcrumbFile">-</span>
 </div>
 <div class="layout">
-<aside class="sidebar" id="tree"></aside>
+<aside class="sidebar">
+  <div class="search-wrap"><input type="text" class="search-input" id="searchInput" placeholder="Filter files..." autocomplete="off"/></div>
+  <div class="tree-actions"><button class="tree-btn" id="expandAll">Expand all</button><button class="tree-btn" id="collapseAll">Collapse all</button></div>
+  <div id="tree"></div>
+</aside>
 <main class="content">
   <div class="file-header" id="fileHeader" style="display:none">
     <span class="file-path" id="headerPath"></span>
@@ -169,12 +187,12 @@ var raw=el?el.textContent:"{}";
 var data=JSON.parse(raw);
 var files=data.files||{}, keys=data.fileKeys||[], treeData=data.tree||{};
 function esc(s){var d=document.createElement("div");d.textContent=s;return d.innerHTML}
-function getLang(path){
-  if(path.endsWith(".ts")||path.endsWith(".tsx"))return"typescript";
-  if(path.endsWith(".js")||path.endsWith(".mjs")||path.endsWith(".cjs"))return"javascript";
-  if(path.endsWith(".json"))return"json";
-  if(path.endsWith(".css"))return"css";
-  if(path.endsWith(".md"))return"markdown";
+function getLang(p){
+  if(p.endsWith(".ts")||p.endsWith(".tsx"))return"typescript";
+  if(p.endsWith(".js")||p.endsWith(".mjs")||p.endsWith(".cjs"))return"javascript";
+  if(p.endsWith(".json"))return"json";
+  if(p.endsWith(".css"))return"css";
+  if(p.endsWith(".md"))return"markdown";
   return"";
 }
 var viewMode="code";
@@ -257,22 +275,52 @@ function renderTree(node, parentEl, indent){
     }
   }
 }
-function buildTree(){
-  var tree=document.getElementById("tree");
-  if(Object.keys(treeData).length>0){
-    renderTree(treeData,tree,0);
+function buildTreeFromKeys(keys){
+  var root={};
+  keys.forEach(function(key){
+    var parts=key.split("/");
+    var curr=root;
+    for(var i=0;i<parts.length;i++){
+      var part=parts[i];
+      var isLast=i===parts.length-1;
+      if(!curr[part])curr[part]=isLast?{path:key}:{};
+      if(isLast)curr[part].path=key;
+      else curr=curr[part];
+    }
+  });
+  return root;
+}
+function buildTree(filterQuery){
+  var treeEl=document.getElementById("tree");
+  treeEl.innerHTML="";
+  var filteredKeys=filterQuery?keys.filter(function(k){return k.toLowerCase().indexOf(filterQuery.toLowerCase())>=0;}):keys;
+  var data=filteredKeys.length?buildTreeFromKeys(filteredKeys):{};
+  if(Object.keys(data).length>0){
+    renderTree(data,treeEl,0);
   }else{
-    keys.sort();
-    keys.forEach(function(k){
+    filteredKeys.sort();
+    filteredKeys.forEach(function(k){
       var div=document.createElement("div");
       div.className="file";
       div.dataset.path=k;
-      div.innerHTML='<span class="icon">'+fileIcon()+'</span>'+esc(k);
+      div.innerHTML='<span class="icon">'+fileIcon()+'</span>'+esc(k.split("/").pop());
       div.onclick=function(){selectFile(k)};
-      tree.appendChild(div);
+      treeEl.appendChild(div);
     });
   }
 }
+document.getElementById("searchInput").oninput=function(){
+  var q=this.value.trim();
+  buildTree(q);
+};
+document.getElementById("expandAll").onclick=function(){
+  document.querySelectorAll(".sidebar .folder.collapsed").forEach(function(f){f.classList.remove("collapsed")});
+  document.querySelectorAll(".sidebar .children.hidden").forEach(function(c){c.classList.remove("hidden")});
+};
+document.getElementById("collapseAll").onclick=function(){
+  document.querySelectorAll(".sidebar .folder").forEach(function(f){f.classList.add("collapsed")});
+  document.querySelectorAll(".sidebar .children").forEach(function(c){c.classList.add("hidden")});
+};
 buildTree();
 })();
 </script>

cli/builders/version-config-builder.mjs

@@ -2,7 +2,6 @@
 
 import {
   ROUTE_PATHS,
-  HTML_PATHS,
   VIDEO_IDS,
   PAGE2_AUDIO,
   SOURCE_VIEWER_META,
@@ -12,6 +11,7 @@ import {
   ROUTE_META_ID2,
   ROUTE_META_ID3,
   ROUTE_META_ID4,
+  ROUTE_META_ID5,
   VIDEO_META_ID1,
   VIDEO_META_ID2,
   VIDEO_META_ID3,
@@ -20,12 +20,12 @@ import {
 } from "../data/route-metas.mjs";
 import { buildMdRoute, buildHtmlRoute, buildVideoRoute } from "./route-builders.mjs";
 
-const ROUTE_METAS = { 1: ROUTE_META_ID1, 2: ROUTE_META_ID2, 3: ROUTE_META_ID3, 4: ROUTE_META_ID4 };
+const ROUTE_METAS = { 1: ROUTE_META_ID1, 2: ROUTE_META_ID2, 3: ROUTE_META_ID3, 4: ROUTE_META_ID4, 5: ROUTE_META_ID5 };
 const VIDEO_METAS = { 1: VIDEO_META_ID1, 2: VIDEO_META_ID2, 3: VIDEO_META_ID3, 4: VIDEO_META_ID4 };
 
 function buildVersionMdRoutes(versionId) {
   const base = `gitpagedocs/docs/versions/${versionId}`;
-  return [1, 2, 3, 4].map((id) => {
+  return [1, 2, 3, 4, 5].map((id) => {
     const paths = ROUTE_PATHS[id];
     const meta = ROUTE_METAS[id];
     const pathByLang = {
@@ -40,19 +40,13 @@ function buildVersionMdRoutes(versionId) {
 
 function buildVersionHtmlRoutes(versionId) {
   const base = `gitpagedocs/docs/versions/${versionId}`;
-  const pathByLang1 = {
-    pt: `${base}/pt/${HTML_PATHS[1].pt}`,
-    en: `${base}/en/${HTML_PATHS[1].en}`,
-    es: `${base}/es/${HTML_PATHS[1].es}`,
-  };
   const pathByLangSource = {
     pt: `${base}/pt/source-viewer`,
     en: `${base}/en/source-viewer`,
     es: `${base}/es/source-viewer`,
   };
   return [
-    buildHtmlRoute(versionId, 1, pathByLang1, ROUTE_META_ID1.titles, ROUTE_META_ID1.descriptions),
-    buildHtmlRoute(versionId, 2, pathByLangSource, SOURCE_VIEWER_META.titles, SOURCE_VIEWER_META.descriptions, {
+    buildHtmlRoute(versionId, 1, pathByLangSource, SOURCE_VIEWER_META.titles, SOURCE_VIEWER_META.descriptions, {
       container: "full",
       blockLink: true,
     }),
@@ -74,7 +68,7 @@ function buildVersionVideoRoutes(versionId) {
 
 function buildVersionMenus(versionId) {
   const base = `gitpagedocs/docs/versions/${versionId}`;
-  const menuMd = [1, 2, 3, 4].map((id) => ({
+  const menuMd = [1, 2, 3, 4, 5].map((id) => ({
     id: id,
     pt: { title: ROUTE_METAS[id].titles.pt, "path-click": `${base}/pt/${ROUTE_PATHS[id].pt}` },
     en: { title: ROUTE_METAS[id].titles.en, "path-click": `${base}/en/${ROUTE_PATHS[id].en}` },
@@ -83,12 +77,6 @@ function buildVersionMenus(versionId) {
   const menuHtml = [
     {
       id: 1,
-      pt: { title: "Primeiros passos (HTML)", "path-click": `${base}/pt/getting-started` },
-      en: { title: "Getting Started (HTML)", "path-click": `${base}/en/getting-started` },
-      es: { title: "Primeros pasos (HTML)", "path-click": `${base}/es/getting-started` },
-    },
-    {
-      id: 2,
       pt: { title: "Código fonte", "path-click": `${base}/pt/source-viewer` },
       en: { title: "Source code", "path-click": `${base}/en/source-viewer` },
       es: { title: "Código fuente", "path-click": `${base}/es/source-viewer` },