handoff-app 1.0.5 → 1.0.6-canary.1

package/Changelog.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## \[1.0.6] - 2026-02-24
+
+Version 1.0.4 fixed an issue when running Handoff in subpaths (eg.
+https://mysite.com/folder/handoff). We discovered a minor bug in that fix that
+causes some menu constructs to work poorly. This release fixes that issue.
+
 ## \[1.0.5] - 2026-02-19
 
 This is a minor improvement release that extends the quickstart released in the

package/dist/cli.js

@@ -19,7 +19,7 @@ class HandoffCliError extends Error {
  * Show the help message
  */
 const showVersion = () => {
-    return 'Handoff App - 1.0.5';
+    return 'Handoff App - 1.0.6';
 };
 /**
  * Define a CLI error

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handoff-app",
-  "version": "1.0.5",
+  "version": "1.0.6-canary.1",
   "description": "Automated documentation toolchain for building client side documentation from figma",
   "author ": {
     "name": "Convertiv",

package/src/app/components/Component/ComponentLists.tsx

@@ -234,7 +234,7 @@ export const AbstractComponentsPageCard = ({
   return (
     <div className={cn(layout === 'single' && 'grid grid-cols-[130px_1fr] items-start gap-6')}>
       <Link href={available ? (absolute ? path : `/system/component/${id}`) : '#'} className="block bg-gray-50">
-        <img src={image} width={1528} height={1250} alt="Components" className="mb-5 rounded-lg" />
+        <img src={`${process.env.HANDOFF_APP_BASE_PATH ?? ''}${image}`} width={1528} height={1250} alt="Components" className="mb-5 rounded-lg" />
       </Link>
       <div>
         <h2 className="text-base font-medium">{title}</h2>

package/src/app/components/util/index.ts

@@ -289,8 +289,15 @@ export const staticBuildMenu = () => {
   return sections.concat(custom).sort((a: SectionLink, b: SectionLink) => a.weight - b.weight);
 };
 
+const buildBasePath = () => {
+  if(!process.env.HANDOFF_APP_BASE_PATH) {
+    return '';
+  }
+  return (process.env.HANDOFF_APP_BASE_PATH ?? '').replace(/^\//, '') + '/';
+};
+
 const staticBuildComponentMenu = (type?: boolean | string) => {
-  const basePath = (process.env.HANDOFF_APP_BASE_PATH ?? '').replace(/^\//, '');
+  const basePath = buildBasePath();
   let menu = [];
   let components = fetchComponents({ includeTokens: false });
   if (typeof type === 'string' && type !== '') {
@@ -309,7 +316,7 @@ const staticBuildComponentMenu = (type?: boolean | string) => {
       if (component.name) {
         title = component.name;
       }
-      menuGroup.menu.push({ path: `${basePath}/system/component/${component.id}`, title });
+      menuGroup.menu.push({ path: `${basePath}system/component/${component.id}`, title });
     });
     // sort the menu group by name alphabetical
     menuGroup.menu = menuGroup.menu.sort((a, b) => a.title.localeCompare(b.title));
@@ -321,24 +328,24 @@ const staticBuildComponentMenu = (type?: boolean | string) => {
 };
 
 const staticBuildTokensMenu = () => {
-  const basePath = (process.env.HANDOFF_APP_BASE_PATH ?? '').replace(/^\//, '');
+  const basePath = buildBasePath();
 
   const menu = [
     {
       title: `Foundations`,
-      path: `${basePath}/system/tokens/foundations`,
+      path: `${basePath}system/tokens/foundations`,
       menu: [
         {
           title: `Colors`,
-          path: `${basePath}/system/tokens/foundations/colors`,
+          path: `${basePath}system/tokens/foundations/colors`,
         },
         {
           title: `Effects`,
-          path: `${basePath}/system/tokens/foundations/effects`,
+          path: `${basePath}system/tokens/foundations/effects`,
         },
         {
           title: `Typography`,
-          path: `${basePath}/system/tokens/foundations/typography`,
+          path: `${basePath}system/tokens/foundations/typography`,
         },
       ],
     },
@@ -358,14 +365,14 @@ const staticBuildTokensMenu = () => {
       if (component.name) {
         title = component.name;
       }
-      componentMenuItems.push({ path: `${basePath}/system/tokens/components/${component.id}`, title });
+      componentMenuItems.push({ path: `${basePath}system/tokens/components/${component.id}`, title });
     });
   });
 
   if (componentMenuItems.length > 0) {
     menu.push({
       title: `Components`,
-      path: `${basePath}/system/tokens/components`,
+      path: `${basePath}system/tokens/components`,
       menu: componentMenuItems,
     });
   }
@@ -374,11 +381,11 @@ const staticBuildTokensMenu = () => {
 };
 
 const staticBuildTokenMenu = () => {
-  const basePath = (process.env.HANDOFF_APP_BASE_PATH ?? '').replace(/^\//, '');
+    const basePath = buildBasePath();
 
   let subSections = {
     title: 'Tokens',
-    path: `${basePath}/system/tokens`,
+    path: `${basePath}system/tokens`,
     menu: [],
   };
   const tokens = getTokens();

package/src/app/pages/system/component/[component]/index.tsx

@@ -115,11 +115,11 @@ const GenericComponentPage = ({ menu, metadata, current, id, config, componentHo
   };
 
   const previousLink = previousComponent ? {
-    href: previousComponent ? '/system/component/' + previousComponent.id : null,
+    href: previousComponent ? `${process.env.HANDOFF_APP_BASE_PATH ?? ''}system/component/${previousComponent.id}` : null,
     title: previousComponent ? previousComponent.name : null,
   } : null;
   const nextLink = nextComponent ? {
-    href: '/system/component/' + nextComponent.id,
+    href: `${process.env.HANDOFF_APP_BASE_PATH ?? ''}system/component/${nextComponent.id}`,
     title: nextComponent.name,
   } : null;
 

package/src/cli.ts

@@ -19,7 +19,7 @@ class HandoffCliError extends Error {
  * Show the help message
  */
 const showVersion = () => {
-  return 'Handoff App - 1.0.5';
+  return 'Handoff App - 1.0.6';
 };
 
 /**