@qwickapps/react-framework 1.5.4 → 1.5.6

package/README.md

@@ -4,6 +4,10 @@ A complete React framework for building modern, responsive applications with int
 
 ## What's New
 
+### December 6, 2025 - Repository URLs Update (v1.5.5)
+
+- Updated repository and homepage URLs to point to public GitHub org
+
 ### December 6, 2025 - Scaffold Layout & Spacing Improvements (v1.5.4)
 
 - **Scaffold Layout Spacing**: Responsive base padding (16px mobile, 24px tablet, 32px desktop) plus nav element clearance

package/dist/components/QwickApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QwickApp.d.ts","sourceRoot":"","sources":["../../src/components/QwickApp.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAmB,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC7G,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,gBAAgB,CAAC;AAQxB,UAAU,sBAAuB,SAAQ,aAAa;IACpD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;IAC5B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CAEpB;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA+GrD,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,oBAM9B,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"QwickApp.d.ts","sourceRoot":"","sources":["../../src/components/QwickApp.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,EAAsE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACjH,OAAO,EAAmB,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC7G,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,gBAAgB,CAAC;AAQxB,UAAU,sBAAuB,SAAQ,aAAa;IACpD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;IAC5B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CAEpB;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAiHrD,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,oBAM9B,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/components/ResponsiveMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponsiveMenu.d.ts","sourceRoot":"","sources":["../../src/components/ResponsiveMenu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,aAAa,EAAoC,MAAM,uBAAuB,CAAC;AAIxF,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,qCAAqC;IACrC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAID,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+QjD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ResponsiveMenu.d.ts","sourceRoot":"","sources":["../../src/components/ResponsiveMenu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,aAAa,EAAoC,MAAM,uBAAuB,CAAC;AAIxF,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,qCAAqC;IACrC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAID,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA8QjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/Scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scaffold.d.ts","sourceRoot":"","sources":["../../src/components/Scaffold.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,+BAA+B;IAC/B,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAWD,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAsarC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Scaffold.d.ts","sourceRoot":"","sources":["../../src/components/Scaffold.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,+BAA+B;IAC/B,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAWD,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAqarC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/components/index.d.ts

@@ -22,6 +22,7 @@ export * from './layout';
 export * from './pages';
 export { default as Scaffold } from './Scaffold';
 export type { ScaffoldProps, AppBarProps } from './Scaffold';
+export type { MenuItem } from './menu/MenuItem';
 export { default as ResponsiveMenu } from './ResponsiveMenu';
 export type { ResponsiveMenuProps } from './ResponsiveMenu';
 export * from './QwickApp';

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,kCAAkC,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,kCAAkC,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/contexts/NavigationContext.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Navigation Context - Smart navigation that auto-detects React Router
+ *
+ * Provides navigation functions that work with React Router when available,
+ * falling back to window.location for non-router apps or SSR.
+ *
+ * Usage:
+ * - Wrap your app with NavigationProvider (done automatically by QwickApp)
+ * - Use useNavigation() hook to get navigate function and location
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { type ReactNode } from 'react';
+/**
+ * Location type matching React Router's location shape
+ */
+export interface NavigationLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+/**
+ * Navigate function type
+ */
+export type NavigateFunction = (to: string | number) => void;
+/**
+ * Navigation context value
+ */
+export interface NavigationContextValue {
+    navigate: NavigateFunction;
+    location: NavigationLocation | undefined;
+}
+/**
+ * Smart Navigation Provider
+ *
+ * Automatically detects if the app is inside a React Router context:
+ * - If inside Router: uses React Router's useNavigate/useLocation (respects basename)
+ * - If outside Router: falls back to window.location
+ *
+ * This is included automatically by QwickApp - you don't need to add it manually.
+ */
+export declare function NavigationProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access navigation functions
+ *
+ * @returns Object containing navigate function and current location
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { navigate, location } = useNavigation();
+ *
+ *   const handleClick = () => {
+ *     navigate('/dashboard');
+ *   };
+ *
+ *   return <button onClick={handleClick}>Go to Dashboard</button>;
+ * }
+ * ```
+ */
+export declare function useNavigation(): NavigationContextValue;
+//# sourceMappingURL=NavigationContext.d.ts.map

package/dist/contexts/NavigationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContext.d.ts","sourceRoot":"","sources":["../../src/contexts/NavigationContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOlE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1C;AAmED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAcvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAWtD"}

package/dist/contexts/index.d.ts

@@ -2,6 +2,8 @@ export { DataProvider, t, T, useData, useDataContext, useDataProvider, useResolv
 export type { DataProviderProps } from './DataContext';
 export { DimensionsProvider, useDimensions } from './DimensionsContext';
 export type { DimensionsContextValue, DimensionTokens } from './DimensionsContext';
+export { NavigationProvider, useNavigation } from './NavigationContext';
+export type { NavigateFunction, NavigationContextValue, NavigationLocation } from './NavigationContext';
 export { PaletteProvider, usePalette } from './PaletteContext';
 export type { PaletteConfig, PaletteContextValue } from './PaletteContext';
 export { ThemeProvider, useTheme } from './ThemeContext';

package/dist/contexts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.esm.js

@@ -4,10 +4,11 @@ import { useMediaQuery, Box, useTheme as useTheme$1, Paper, Typography, Tooltip,
 import React, { useMemo, useContext, useState, useCallback, useEffect, createContext, useReducer, useRef, isValidElement, createElement, useId, useLayoutEffect, Component, cloneElement } from 'react';
 import { MustacheTemplateProvider, MemoryCacheProvider, CachedDataProvider, Field, Editor, FieldType, Schema, Model, DataType } from '@qwickapps/schema';
 import { createTheme, ThemeProvider as ThemeProvider$1 } from '@mui/material/styles';
-import { Check, ContentCopy, Home, Menu, Dashboard, Info, Help, Book, Email, Phone, Send, Add, Edit, Delete, Save, Close, ArrowForward, ArrowBack, Search, Share, Download, CloudDownload, CloudUpload, Person, Group, Favorite, Star, VerifiedUser, Business, ShoppingCart, AttachMoney, Lock, LockOpen, Visibility, VisibilityOff, Settings, Computer, Article as Article$1, Inventory, Inventory2, Speed, SupportAgent, Tune, Code as Code$1, Psychology, Autorenew, IntegrationInstructions, Construction, Work, Layers, TrendingUp, Route, Sync, Architecture, Security, Key, VpnKey, PersonSearch, ManageAccounts, Storage, Refresh, Block, CheckCircle, RotateRight, Memory, BrokenImage, MoreVert, FormatBold, FormatItalic, FormatUnderlined, ExpandMore, ExpandLess, Schedule, Launch, LightMode, DarkMode, SettingsSystemDaydream, Palette, Circle, RadioButtonUnchecked } from '@mui/icons-material';
+import { Check, ContentCopy, Home, Menu, Dashboard, Info, Help, Book, Email, Phone, Send, Add, Edit, Delete, Save, Close, ArrowForward, ArrowBack, Search, Share, Download, CloudDownload, CloudUpload, Person, Group, Favorite, Star, VerifiedUser, Business, ShoppingCart, AttachMoney, Lock, LockOpen, Visibility, VisibilityOff, Settings, Computer, Article as Article$1, Inventory, Inventory2, Speed, SupportAgent, Tune, Code as Code$1, Psychology, Autorenew, IntegrationInstructions, Construction, Work, Layers, TrendingUp, Route, Sync, Architecture, Security, Key, VpnKey, PersonSearch, ManageAccounts, Storage, Refresh, Block, CheckCircle, RotateRight, Memory, LocalOffer, BrokenImage, MoreVert, FormatBold, FormatItalic, FormatUnderlined, ExpandMore, ExpandLess, Schedule, Launch, LightMode, DarkMode, SettingsSystemDaydream, Palette, Circle, RadioButtonUnchecked } from '@mui/icons-material';
 import { IsOptional, ValidateIf, IsIn, IsInt, Min, IsString, IsNotEmpty, IsBoolean, IsNumber, Max, IsArray, ValidateNested, IsUrl, IsObject } from 'class-validator';
 import 'reflect-metadata';
 import { Type } from 'class-transformer';
+import { UNSAFE_NavigationContext, useNavigate, useLocation } from 'react-router-dom';
 
 /**
  * Breakpoint utilities for QwickApps React Framework
@@ -3384,6 +3385,10 @@ const iconMap = {
   memory: {
     emoji: '🧠',
     component: Memory
+  },
+  local_offer: {
+    emoji: '🏷️',
+    component: LocalOffer
   }
 };
 /**
@@ -4815,41 +4820,6 @@ var FormBlockModel$1 = FormBlockModel;
  *
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
-/**
- * Get the current location from browser or undefined in SSR
- * Works without relying on routing libraries
- * @returns {object | undefined} - The location object if in browser, otherwise undefined
- */
-const useSafeLocation = () => {
-  // Use browser location if available (works in any React app)
-  if (typeof window !== 'undefined') {
-    return {
-      pathname: window.location.pathname,
-      search: window.location.search,
-      hash: window.location.hash
-    };
-  }
-  return undefined;
-};
-/**
- * Get a navigation function with fallback to window.location
- * Works without relying on routing libraries
- * @returns {NavigateFunction} - The navigate function
- */
-const useSafeNavigate = () => {
-  // Return function that uses window.location
-  return to => {
-    if (typeof to === 'string') {
-      if (typeof window !== 'undefined') {
-        window.location.href = to;
-      }
-    } else if (typeof to === 'number') {
-      if (typeof window !== 'undefined' && window.history) {
-        window.history.go(to);
-      }
-    }
-  };
-};
 /**
  * Extract text content from ReactNode for code processing
  * Handles natural React usage like <Code>const x = 1;</Code>
@@ -23386,6 +23356,115 @@ const useDimensions = () => {
   return context;
 };
 
+const NavigationContext = /*#__PURE__*/createContext(null);
+/**
+ * Internal provider that uses React Router hooks
+ * Only rendered when we're inside a Router context
+ */
+function ReactRouterNavigationProvider({
+  children
+}) {
+  const reactRouterNavigate = useNavigate();
+  const reactRouterLocation = useLocation();
+  const navigate = to => {
+    if (typeof to === 'string') {
+      reactRouterNavigate(to);
+    } else if (typeof to === 'number') {
+      reactRouterNavigate(to);
+    }
+  };
+  return jsx(NavigationContext.Provider, {
+    value: {
+      navigate,
+      location: {
+        pathname: reactRouterLocation.pathname,
+        search: reactRouterLocation.search,
+        hash: reactRouterLocation.hash
+      }
+    },
+    children: children
+  });
+}
+/**
+ * Internal provider that uses window.location fallback
+ * Used when not inside a React Router context
+ */
+function FallbackNavigationProvider({
+  children
+}) {
+  const navigate = to => {
+    if (typeof window === 'undefined') return;
+    if (typeof to === 'string') {
+      window.location.href = to;
+    } else if (typeof to === 'number') {
+      window.history.go(to);
+    }
+  };
+  const location = typeof window !== 'undefined' ? {
+    pathname: window.location.pathname,
+    search: window.location.search,
+    hash: window.location.hash
+  } : undefined;
+  return jsx(NavigationContext.Provider, {
+    value: {
+      navigate,
+      location
+    },
+    children: children
+  });
+}
+/**
+ * Smart Navigation Provider
+ *
+ * Automatically detects if the app is inside a React Router context:
+ * - If inside Router: uses React Router's useNavigate/useLocation (respects basename)
+ * - If outside Router: falls back to window.location
+ *
+ * This is included automatically by QwickApp - you don't need to add it manually.
+ */
+function NavigationProvider({
+  children
+}) {
+  // Check if we're inside a React Router by checking its internal context
+  // useContext doesn't throw - it returns null if the context doesn't exist
+  const routerContext = useContext(UNSAFE_NavigationContext);
+  if (routerContext) {
+    // We're inside a Router, use React Router's navigation
+    return jsx(ReactRouterNavigationProvider, {
+      children: children
+    });
+  }
+  // Not inside a Router, use window.location fallback
+  return jsx(FallbackNavigationProvider, {
+    children: children
+  });
+}
+/**
+ * Hook to access navigation functions
+ *
+ * @returns Object containing navigate function and current location
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { navigate, location } = useNavigation();
+ *
+ *   const handleClick = () => {
+ *     navigate('/dashboard');
+ *   };
+ *
+ *   return <button onClick={handleClick}>Go to Dashboard</button>;
+ * }
+ * ```
+ */
+function useNavigation() {
+  const context = useContext(NavigationContext);
+  if (!context) {
+    throw new Error('useNavigation must be used within a NavigationProvider. ' + 'Make sure your component is wrapped in QwickApp or NavigationProvider.');
+  }
+  return context;
+}
+
 /**
  * Schema for PaletteSwitcher component - Color palette switching control
  *
@@ -24533,7 +24612,9 @@ const PageView = ({
     };
   }, [isPrintMode, printConfig]);
   // Route (fallback to current location)
-  const location = useSafeLocation();
+  const {
+    location
+  } = useNavigation();
   const actualRoute = resolved.route || location?.pathname || '';
   // Context value
   const contextValue = useMemo(() => ({
@@ -24648,9 +24729,11 @@ const Scaffold = ({
   const [isDrawerOpen, setIsDrawerOpen] = useState(false);
   const [isRailExpanded, setIsRailExpanded] = useState(false);
   const [isMounted, setIsMounted] = useState(false);
-  // React Router hooks (if available)
-  const location = useSafeLocation();
-  const navigate = useSafeNavigate();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const {
+    navigate,
+    location
+  } = useNavigation();
   const currentPath = isMounted ? location?.pathname : undefined;
   // Debug logging for navigation
   React.useEffect(() => {
@@ -25019,9 +25102,11 @@ const ResponsiveMenu = props => {
     appName,
     logo: contextLogo
   } = useQwickApp$1();
-  // React Router hooks (if available)
-  const navigate = useSafeNavigate();
-  const location = useSafeLocation();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const {
+    navigate,
+    location
+  } = useNavigation();
   const currentPath = location?.pathname;
   // Debug logging
   React.useEffect(() => {
@@ -25923,17 +26008,19 @@ const QwickApp = ({
   }) : content;
   const appContent = jsx(ErrorBoundary, {
     children: jsx(AccessibilityProvider, {
-      children: jsx("div", {
-        className: `qwick-app ${className || ''}`,
-        style: style,
-        children: jsx(ThemeProvider, {
-          appId: resolvedConfig.appId,
-          defaultTheme: resolvedConfig.defaultTheme,
-          defaultPalette: resolvedConfig.defaultPalette,
-          children: jsx(QwickAppContext.Provider, {
-            value: contextValue,
-            children: jsx(PrintModeProvider, {
-              children: wrappedContent
+      children: jsx(NavigationProvider, {
+        children: jsx("div", {
+          className: `qwick-app ${className || ''}`,
+          style: style,
+          children: jsx(ThemeProvider, {
+            appId: resolvedConfig.appId,
+            defaultTheme: resolvedConfig.defaultTheme,
+            defaultPalette: resolvedConfig.defaultPalette,
+            children: jsx(QwickAppContext.Provider, {
+              value: contextValue,
+              children: jsx(PrintModeProvider, {
+                children: wrappedContent
+              })
             })
           })
         })
@@ -31808,4 +31895,4 @@ __decorate([Field({
 }), IsOptional(), __metadata("design:type", Boolean)], PageTemplateSchema.prototype, "indexable", void 0);
 PageTemplateSchema = __decorate([Schema('PageTemplate', '1.0.0')], PageTemplateSchema);
 
-export { AVAILABLE_PALETTES, AccessibilityProvider, ActionModel, ActionType, AllPalettes, AppConfig, AppConfigBuilder, Article, ArticleModel, Breadcrumbs, Button, Captcha, CardListGrid, CardListGridModel, ChoiceInputField, ChoiceInputFieldModel, Code, CodeModel, CollapsibleLayout, CollapsibleLayoutView, ComponentTransformer$1 as ComponentTransformer, Container$8 as Container, Content, ContentModel, CoverImageHeader, CoverImageHeaderModel, DataProvider, DataProxy, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, DimensionsProvider, ErrorBoundary, FeatureCard, FeatureCardActionModel, FeatureCardModel, FeatureGrid, FeatureGridModel, FeatureItemModel, Footer, FooterItemModel, FooterModel, FooterSectionModel, FormBlock, FormBlockModel, FormCheckbox, FormField, FormMethod, FormPage, FormSelect, GridCell, GridCellModel, GridLayout, GridLayoutModel, HeaderActionModel, HeroBlock, HeroBlockModel, Html, HtmlInputField, HtmlModel, Image, ImageModel, Logo, Markdown, MarkdownModel, MetadataItemModel, ModelView, Page, PageBannerHeader, PageBannerHeaderModel, PageTemplateSchema, PaletteAutumn, PaletteCosmic, PaletteDefault, PaletteOcean, PaletteProvider, PaletteSpring, PaletteSwitcher, PaletteSwitcherModel, PaletteWinter, PrintConfigSchema, PrintModeProvider, ProductCard, ProductCardActionModel, ProductCardModel, ProductLogo, ProductModel, QWICKAPP_COMPONENT, QwickApp, QwickAppsLogo, QwickIcon, ResponsiveMenu, SafeSpan, SafeSpanModel, Scaffold, Section, SectionModel, SelectInputField, SwitchInputField, T, Text$1 as Text, TextField, TextInputField, TextInputFieldModel, TextModel, ThemeProvider, ThemeSwitcher, ThemeSwitcherModel, ViewSchema, animationConfigs, applyCustomPalette, clearManifestCache, clearPaletteCache, clearUserPalettePreference, clearUserThemePreference, configurePaletteLoader, createAppConfig, createModelViewClass, createPaletteFromCurrentTheme, createSerializableView, defaultCollapsibleLayoutProps, deleteCustomPalette, exportPalette, extractTextFromReactNode, getAvailablePalettes, getCSSVariable, getComputedTheme, getCurrentPalette, getCurrentTheme, getCustomPalettes, getIconComponent, getIconEmoji, getLogger, getPaletteConfig, getPaletteFromManifest, getPaletteName, getRegisteredIcons, getSystemTheme, getThemePerformanceStats, hasIcon, iconMap, importPalette, initializePalette, initializeTheme, isCollapsibleLayoutProps, isPaletteLoaded, loadPalette, loadPaletteManifest, loadUserPalettePreference, loadUserThemePreference, logThemePerformanceStats, loggers, preloadPalettes, registerCustomPalette, registerIcon, resetThemePerformanceStats, resolveDimension, resolveDimensions, resolveSpacing, resolveSpacingProps, saveCustomPalette, savePalettePreference, saveThemePreference, saveUserPalettePreference, saveUserThemePreference, setCSSVariable, setPalette, setTheme, spacingConfigs, t, toCssLength, useAccessibility, useBaseProps, useBreadcrumbs, useCollapsibleState, useData, useDataBinding, useDataContext, useDataProvider, useDimensions, usePageContext, usePalette, usePrintMode$1 as usePrintMode, usePrintMode as usePrintModeHook, useQwickApp, useResolveTemplate, useSafeLocation, useSafeNavigate, useTemplate, useTheme, withAccessibility, withErrorBoundary };
+export { AVAILABLE_PALETTES, AccessibilityProvider, ActionModel, ActionType, AllPalettes, AppConfig, AppConfigBuilder, Article, ArticleModel, Breadcrumbs, Button, Captcha, CardListGrid, CardListGridModel, ChoiceInputField, ChoiceInputFieldModel, Code, CodeModel, CollapsibleLayout, CollapsibleLayoutView, ComponentTransformer$1 as ComponentTransformer, Container$8 as Container, Content, ContentModel, CoverImageHeader, CoverImageHeaderModel, DataProvider, DataProxy, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, DimensionsProvider, ErrorBoundary, FeatureCard, FeatureCardActionModel, FeatureCardModel, FeatureGrid, FeatureGridModel, FeatureItemModel, Footer, FooterItemModel, FooterModel, FooterSectionModel, FormBlock, FormBlockModel, FormCheckbox, FormField, FormMethod, FormPage, FormSelect, GridCell, GridCellModel, GridLayout, GridLayoutModel, HeaderActionModel, HeroBlock, HeroBlockModel, Html, HtmlInputField, HtmlModel, Image, ImageModel, Logo, Markdown, MarkdownModel, MetadataItemModel, ModelView, NavigationProvider, Page, PageBannerHeader, PageBannerHeaderModel, PageTemplateSchema, PaletteAutumn, PaletteCosmic, PaletteDefault, PaletteOcean, PaletteProvider, PaletteSpring, PaletteSwitcher, PaletteSwitcherModel, PaletteWinter, PrintConfigSchema, PrintModeProvider, ProductCard, ProductCardActionModel, ProductCardModel, ProductLogo, ProductModel, QWICKAPP_COMPONENT, QwickApp, QwickAppsLogo, QwickIcon, ResponsiveMenu, SafeSpan, SafeSpanModel, Scaffold, Section, SectionModel, SelectInputField, SwitchInputField, T, Text$1 as Text, TextField, TextInputField, TextInputFieldModel, TextModel, ThemeProvider, ThemeSwitcher, ThemeSwitcherModel, ViewSchema, animationConfigs, applyCustomPalette, clearManifestCache, clearPaletteCache, clearUserPalettePreference, clearUserThemePreference, configurePaletteLoader, createAppConfig, createModelViewClass, createPaletteFromCurrentTheme, createSerializableView, defaultCollapsibleLayoutProps, deleteCustomPalette, exportPalette, extractTextFromReactNode, getAvailablePalettes, getCSSVariable, getComputedTheme, getCurrentPalette, getCurrentTheme, getCustomPalettes, getIconComponent, getIconEmoji, getLogger, getPaletteConfig, getPaletteFromManifest, getPaletteName, getRegisteredIcons, getSystemTheme, getThemePerformanceStats, hasIcon, iconMap, importPalette, initializePalette, initializeTheme, isCollapsibleLayoutProps, isPaletteLoaded, loadPalette, loadPaletteManifest, loadUserPalettePreference, loadUserThemePreference, logThemePerformanceStats, loggers, preloadPalettes, registerCustomPalette, registerIcon, resetThemePerformanceStats, resolveDimension, resolveDimensions, resolveSpacing, resolveSpacingProps, saveCustomPalette, savePalettePreference, saveThemePreference, saveUserPalettePreference, saveUserThemePreference, setCSSVariable, setPalette, setTheme, spacingConfigs, t, toCssLength, useAccessibility, useBaseProps, useBreadcrumbs, useCollapsibleState, useData, useDataBinding, useDataContext, useDataProvider, useDimensions, useNavigation, usePageContext, usePalette, usePrintMode$1 as usePrintMode, usePrintMode as usePrintModeHook, useQwickApp, useResolveTemplate, useTemplate, useTheme, withAccessibility, withErrorBoundary };

package/dist/index.js

@@ -10,6 +10,7 @@ var iconsMaterial = require('@mui/icons-material');
 var classValidator = require('class-validator');
 require('reflect-metadata');
 var classTransformer = require('class-transformer');
+var reactRouterDom = require('react-router-dom');
 
 /**
  * Breakpoint utilities for QwickApps React Framework
@@ -3386,6 +3387,10 @@ const iconMap = {
   memory: {
     emoji: '🧠',
     component: iconsMaterial.Memory
+  },
+  local_offer: {
+    emoji: '🏷️',
+    component: iconsMaterial.LocalOffer
   }
 };
 /**
@@ -4817,41 +4822,6 @@ var FormBlockModel = exports.FormBlockModel;
  *
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
-/**
- * Get the current location from browser or undefined in SSR
- * Works without relying on routing libraries
- * @returns {object | undefined} - The location object if in browser, otherwise undefined
- */
-const useSafeLocation = () => {
-  // Use browser location if available (works in any React app)
-  if (typeof window !== 'undefined') {
-    return {
-      pathname: window.location.pathname,
-      search: window.location.search,
-      hash: window.location.hash
-    };
-  }
-  return undefined;
-};
-/**
- * Get a navigation function with fallback to window.location
- * Works without relying on routing libraries
- * @returns {NavigateFunction} - The navigate function
- */
-const useSafeNavigate = () => {
-  // Return function that uses window.location
-  return to => {
-    if (typeof to === 'string') {
-      if (typeof window !== 'undefined') {
-        window.location.href = to;
-      }
-    } else if (typeof to === 'number') {
-      if (typeof window !== 'undefined' && window.history) {
-        window.history.go(to);
-      }
-    }
-  };
-};
 /**
  * Extract text content from ReactNode for code processing
  * Handles natural React usage like <Code>const x = 1;</Code>
@@ -23388,6 +23358,115 @@ const useDimensions = () => {
   return context;
 };
 
+const NavigationContext = /*#__PURE__*/React.createContext(null);
+/**
+ * Internal provider that uses React Router hooks
+ * Only rendered when we're inside a Router context
+ */
+function ReactRouterNavigationProvider({
+  children
+}) {
+  const reactRouterNavigate = reactRouterDom.useNavigate();
+  const reactRouterLocation = reactRouterDom.useLocation();
+  const navigate = to => {
+    if (typeof to === 'string') {
+      reactRouterNavigate(to);
+    } else if (typeof to === 'number') {
+      reactRouterNavigate(to);
+    }
+  };
+  return jsxRuntime.jsx(NavigationContext.Provider, {
+    value: {
+      navigate,
+      location: {
+        pathname: reactRouterLocation.pathname,
+        search: reactRouterLocation.search,
+        hash: reactRouterLocation.hash
+      }
+    },
+    children: children
+  });
+}
+/**
+ * Internal provider that uses window.location fallback
+ * Used when not inside a React Router context
+ */
+function FallbackNavigationProvider({
+  children
+}) {
+  const navigate = to => {
+    if (typeof window === 'undefined') return;
+    if (typeof to === 'string') {
+      window.location.href = to;
+    } else if (typeof to === 'number') {
+      window.history.go(to);
+    }
+  };
+  const location = typeof window !== 'undefined' ? {
+    pathname: window.location.pathname,
+    search: window.location.search,
+    hash: window.location.hash
+  } : undefined;
+  return jsxRuntime.jsx(NavigationContext.Provider, {
+    value: {
+      navigate,
+      location
+    },
+    children: children
+  });
+}
+/**
+ * Smart Navigation Provider
+ *
+ * Automatically detects if the app is inside a React Router context:
+ * - If inside Router: uses React Router's useNavigate/useLocation (respects basename)
+ * - If outside Router: falls back to window.location
+ *
+ * This is included automatically by QwickApp - you don't need to add it manually.
+ */
+function NavigationProvider({
+  children
+}) {
+  // Check if we're inside a React Router by checking its internal context
+  // useContext doesn't throw - it returns null if the context doesn't exist
+  const routerContext = React.useContext(reactRouterDom.UNSAFE_NavigationContext);
+  if (routerContext) {
+    // We're inside a Router, use React Router's navigation
+    return jsxRuntime.jsx(ReactRouterNavigationProvider, {
+      children: children
+    });
+  }
+  // Not inside a Router, use window.location fallback
+  return jsxRuntime.jsx(FallbackNavigationProvider, {
+    children: children
+  });
+}
+/**
+ * Hook to access navigation functions
+ *
+ * @returns Object containing navigate function and current location
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { navigate, location } = useNavigation();
+ *
+ *   const handleClick = () => {
+ *     navigate('/dashboard');
+ *   };
+ *
+ *   return <button onClick={handleClick}>Go to Dashboard</button>;
+ * }
+ * ```
+ */
+function useNavigation() {
+  const context = React.useContext(NavigationContext);
+  if (!context) {
+    throw new Error('useNavigation must be used within a NavigationProvider. ' + 'Make sure your component is wrapped in QwickApp or NavigationProvider.');
+  }
+  return context;
+}
+
 /**
  * Schema for PaletteSwitcher component - Color palette switching control
  *
@@ -24535,7 +24614,9 @@ const PageView = ({
     };
   }, [isPrintMode, printConfig]);
   // Route (fallback to current location)
-  const location = useSafeLocation();
+  const {
+    location
+  } = useNavigation();
   const actualRoute = resolved.route || location?.pathname || '';
   // Context value
   const contextValue = React.useMemo(() => ({
@@ -24650,9 +24731,11 @@ const Scaffold = ({
   const [isDrawerOpen, setIsDrawerOpen] = React.useState(false);
   const [isRailExpanded, setIsRailExpanded] = React.useState(false);
   const [isMounted, setIsMounted] = React.useState(false);
-  // React Router hooks (if available)
-  const location = useSafeLocation();
-  const navigate = useSafeNavigate();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const {
+    navigate,
+    location
+  } = useNavigation();
   const currentPath = isMounted ? location?.pathname : undefined;
   // Debug logging for navigation
   React.useEffect(() => {
@@ -25021,9 +25104,11 @@ const ResponsiveMenu = props => {
     appName,
     logo: contextLogo
   } = useQwickApp$1();
-  // React Router hooks (if available)
-  const navigate = useSafeNavigate();
-  const location = useSafeLocation();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const {
+    navigate,
+    location
+  } = useNavigation();
   const currentPath = location?.pathname;
   // Debug logging
   React.useEffect(() => {
@@ -25925,17 +26010,19 @@ const QwickApp = ({
   }) : content;
   const appContent = jsxRuntime.jsx(ErrorBoundary, {
     children: jsxRuntime.jsx(AccessibilityProvider, {
-      children: jsxRuntime.jsx("div", {
-        className: `qwick-app ${className || ''}`,
-        style: style,
-        children: jsxRuntime.jsx(ThemeProvider, {
-          appId: resolvedConfig.appId,
-          defaultTheme: resolvedConfig.defaultTheme,
-          defaultPalette: resolvedConfig.defaultPalette,
-          children: jsxRuntime.jsx(QwickAppContext.Provider, {
-            value: contextValue,
-            children: jsxRuntime.jsx(PrintModeProvider, {
-              children: wrappedContent
+      children: jsxRuntime.jsx(NavigationProvider, {
+        children: jsxRuntime.jsx("div", {
+          className: `qwick-app ${className || ''}`,
+          style: style,
+          children: jsxRuntime.jsx(ThemeProvider, {
+            appId: resolvedConfig.appId,
+            defaultTheme: resolvedConfig.defaultTheme,
+            defaultPalette: resolvedConfig.defaultPalette,
+            children: jsxRuntime.jsx(QwickAppContext.Provider, {
+              value: contextValue,
+              children: jsxRuntime.jsx(PrintModeProvider, {
+                children: wrappedContent
+              })
             })
           })
         })
@@ -31854,6 +31941,7 @@ exports.Image = Image;
 exports.Logo = Logo;
 exports.Markdown = Markdown;
 exports.ModelView = ModelView;
+exports.NavigationProvider = NavigationProvider;
 exports.Page = Page;
 exports.PageBannerHeader = PageBannerHeader;
 exports.PaletteAutumn = PaletteAutumn;
@@ -31954,14 +32042,13 @@ exports.useDataBinding = useDataBinding;
 exports.useDataContext = useDataContext;
 exports.useDataProvider = useDataProvider;
 exports.useDimensions = useDimensions;
+exports.useNavigation = useNavigation;
 exports.usePageContext = usePageContext;
 exports.usePalette = usePalette;
 exports.usePrintMode = usePrintMode$1;
 exports.usePrintModeHook = usePrintMode;
 exports.useQwickApp = useQwickApp;
 exports.useResolveTemplate = useResolveTemplate;
-exports.useSafeLocation = useSafeLocation;
-exports.useSafeNavigate = useSafeNavigate;
 exports.useTemplate = useTemplate;
 exports.useTheme = useTheme;
 exports.withAccessibility = withAccessibility;

package/dist/palettes/manifest.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./manifest.schema.json",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "palettes": [
     {
       "id": "default",
@@ -8,11 +8,11 @@
       "description": "Classic blue and neutral color scheme - the original QwickApps palette",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-default.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-default.1.5.6.css",
       "primaryColor": "#007bff",
       "inlined": true,
-      "fileMinified": "palette-default.1.5.4.min.css",
+      "fileMinified": "palette-default.1.5.6.min.css",
       "fileLatest": "palette-default.latest.css",
       "fileLatestMinified": "palette-default.latest.min.css"
     },
@@ -22,11 +22,11 @@
       "description": "Warm oranges, golden yellows, and earthy browns - inspired by fall foliage",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-autumn.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-autumn.1.5.6.css",
       "primaryColor": "#ea580c",
       "inlined": false,
-      "fileMinified": "palette-autumn.1.5.4.min.css",
+      "fileMinified": "palette-autumn.1.5.6.min.css",
       "fileLatest": "palette-autumn.latest.css",
       "fileLatestMinified": "palette-autumn.latest.min.css"
     },
@@ -36,11 +36,11 @@
       "description": "Modern purple gradient for creative and tech brands - inspired by cosmic nebulae",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-cosmic.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-cosmic.1.5.6.css",
       "primaryColor": "#8b5cf6",
       "inlined": false,
-      "fileMinified": "palette-cosmic.1.5.4.min.css",
+      "fileMinified": "palette-cosmic.1.5.6.min.css",
       "fileLatest": "palette-cosmic.latest.css",
       "fileLatestMinified": "palette-cosmic.latest.min.css"
     },
@@ -50,11 +50,11 @@
       "description": "Deep blues, aqua teals, and seafoam greens - inspired by ocean depths",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-ocean.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-ocean.1.5.6.css",
       "primaryColor": "#0891b2",
       "inlined": false,
-      "fileMinified": "palette-ocean.1.5.4.min.css",
+      "fileMinified": "palette-ocean.1.5.6.min.css",
       "fileLatest": "palette-ocean.latest.css",
       "fileLatestMinified": "palette-ocean.latest.min.css"
     },
@@ -64,11 +64,11 @@
       "description": "Fresh greens, soft pinks, and bright yellows - inspired by spring blooms",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-spring.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-spring.1.5.6.css",
       "primaryColor": "#16a34a",
       "inlined": false,
-      "fileMinified": "palette-spring.1.5.4.min.css",
+      "fileMinified": "palette-spring.1.5.6.min.css",
       "fileLatest": "palette-spring.latest.css",
       "fileLatestMinified": "palette-spring.latest.min.css"
     },
@@ -78,11 +78,11 @@
       "description": "Cool blues, icy whites, and frosty grays - inspired by winter landscapes",
       "author": "QwickApps",
       "license": "PolyForm-Shield-1.0.0",
-      "version": "1.5.4",
-      "file": "palette-winter.1.5.4.css",
+      "version": "1.5.6",
+      "file": "palette-winter.1.5.6.css",
       "primaryColor": "#0077be",
       "inlined": false,
-      "fileMinified": "palette-winter.1.5.4.min.css",
+      "fileMinified": "palette-winter.1.5.6.min.css",
       "fileLatest": "palette-winter.latest.css",
       "fileLatestMinified": "palette-winter.latest.min.css"
     }

package/dist/utils/iconMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iconMap.d.ts","sourceRoot":"","sources":["../../src/utils/iconMap.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAsE1B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAoG/C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAa,GAAG,MAAM,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAWxF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}
+{"version":3,"file":"iconMap.d.ts","sourceRoot":"","sources":["../../src/utils/iconMap.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAuE1B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAqG/C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAa,GAAG,MAAM,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAWxF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/utils/reactUtils.d.ts

@@ -5,28 +5,6 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 import { ReactNode } from 'react';
-/** Location type for routing */
-type LocationType = {
-    pathname: string;
-    search: string;
-    hash: string;
-};
-/**
- * Get the current location from browser or undefined in SSR
- * Works without relying on routing libraries
- * @returns {object | undefined} - The location object if in browser, otherwise undefined
- */
-export declare const useSafeLocation: () => LocationType | undefined;
-/**
- * Navigate function type
- */
-export type NavigateFunction = (to: string | number, options?: unknown) => void;
-/**
- * Get a navigation function with fallback to window.location
- * Works without relying on routing libraries
- * @returns {NavigateFunction} - The navigate function
- */
-export declare const useSafeNavigate: () => NavigateFunction;
 /**
  * Extract text content from ReactNode for code processing
  * Handles natural React usage like <Code>const x = 1;</Code>
@@ -35,5 +13,4 @@ export declare const useSafeNavigate: () => NavigateFunction;
  * @returns String representation of the node's text content
  */
 export declare function extractTextFromReactNode(node: ReactNode): string;
-export {};
 //# sourceMappingURL=reactUtils.d.ts.map

package/dist/utils/reactUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactUtils.d.ts","sourceRoot":"","sources":["../../src/utils/reactUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,gCAAgC;AAChC,KAAK,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,YAAY,GAAG,SAUjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,gBAalC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BhE"}
+{"version":3,"file":"reactUtils.d.ts","sourceRoot":"","sources":["../../src/utils/reactUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BhE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwickapps/react-framework",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "type": "module",
   "description": "Complete React framework with responsive navigation, flexible layouts, theming system, and reusable components for building modern applications.",
   "main": "dist/index.js",
@@ -178,7 +178,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/raajkumars/qwickapps.git",
-    "directory": "packages/qwickapps-react-framework"
-  }
+    "url": "https://github.com/qwickapps/react-framework.git"
+  },
+  "homepage": "https://github.com/qwickapps/react-framework#readme"
 }

package/src/components/QwickApp.tsx

@@ -35,7 +35,7 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 import React, { cloneElement, useState } from 'react';
-import { DataProvider, ThemeProvider, PrintModeProvider, type ThemeMode } from '../contexts';
+import { DataProvider, ThemeProvider, PrintModeProvider, NavigationProvider, type ThemeMode } from '../contexts';
 import { QwickAppContext, type QwickAppContextValue, type QwickAppProps } from '../contexts/QwickAppContext';
 import { type TemplateResolverConfig } from '../types';
 import { AppConfig } from '../config';
@@ -160,19 +160,21 @@ export const QwickApp: React.FC<QwickAppComponentProps> = ({
   const appContent = (
     <ErrorBoundary>
       <AccessibilityProvider>
-        <div className={`qwick-app ${className || ''}`} style={style}>
-          <ThemeProvider 
-            appId={resolvedConfig.appId} 
-            defaultTheme={resolvedConfig.defaultTheme} 
-            defaultPalette={resolvedConfig.defaultPalette}
-          >
-            <QwickAppContext.Provider value={contextValue}>
-              <PrintModeProvider>
-                {wrappedContent}
-              </PrintModeProvider>
-            </QwickAppContext.Provider>
-          </ThemeProvider>
-        </div>
+        <NavigationProvider>
+          <div className={`qwick-app ${className || ''}`} style={style}>
+            <ThemeProvider
+              appId={resolvedConfig.appId}
+              defaultTheme={resolvedConfig.defaultTheme}
+              defaultPalette={resolvedConfig.defaultPalette}
+            >
+              <QwickAppContext.Provider value={contextValue}>
+                <PrintModeProvider>
+                  {wrappedContent}
+                </PrintModeProvider>
+              </QwickAppContext.Provider>
+            </ThemeProvider>
+          </div>
+        </NavigationProvider>
       </AccessibilityProvider>
     </ErrorBoundary>
   );

package/src/components/ResponsiveMenu.tsx

@@ -22,7 +22,7 @@ import { useQwickApp } from '../contexts/QwickAppContext';
 import Logo from './Logo';
 import { getIconComponent } from './buttons/Button';
 import './ResponsiveMenu.css';
-import { useSafeLocation, useSafeNavigate } from '../utils/reactUtils';
+import { useNavigation } from '../contexts/NavigationContext';
 import { loggers } from '../utils/logger';
 import type { MenuItem } from './menu/MenuItem';
 
@@ -63,9 +63,8 @@ const ResponsiveMenu: React.FC<ResponsiveMenuProps> = (props) => {
   const [isDrawerOpen, setIsDrawerOpen] = useState(false);
   const { appName, logo: contextLogo } = useQwickApp();
 
-  // React Router hooks (if available)
-  const navigate = useSafeNavigate();
-  const location = useSafeLocation();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const { navigate, location } = useNavigation();
   const currentPath = location?.pathname;
   
   // Debug logging

package/src/components/Scaffold.tsx

@@ -24,7 +24,7 @@ import PaletteSwitcher from './buttons/PaletteSwitcher';
 import { RadioButtonUnchecked as DefaultIcon } from '@mui/icons-material';
 import { getIconComponent } from './buttons/Button';
 import './Scaffold.css';
-import { useSafeLocation, useSafeNavigate } from '../utils/reactUtils';
+import { useNavigation } from '../contexts/NavigationContext';
 import { loggers } from '../utils/logger';
 import type { MenuItem } from './menu/MenuItem';
 
@@ -92,9 +92,8 @@ const Scaffold: React.FC<ScaffoldProps> = ({
   const [isRailExpanded, setIsRailExpanded] = useState(false);
   const [isMounted, setIsMounted] = useState(false);
 
-  // React Router hooks (if available)
-  const location = useSafeLocation();
-  const navigate = useSafeNavigate();
+  // Navigation (uses React Router if available, falls back to window.location)
+  const { navigate, location } = useNavigation();
   const currentPath = isMounted ? location?.pathname : undefined;
   
   // Debug logging for navigation

package/src/components/index.ts

@@ -25,6 +25,7 @@ export * from './layout';
 export * from './pages';
 export { default as Scaffold } from './Scaffold';
 export type { ScaffoldProps, AppBarProps } from './Scaffold';
+export type { MenuItem } from './menu/MenuItem';
 export { default as ResponsiveMenu } from './ResponsiveMenu';
 export type { ResponsiveMenuProps } from './ResponsiveMenu';
 export * from './QwickApp';

package/src/components/pages/Page.tsx

@@ -38,7 +38,7 @@ import { usePrintMode } from '../../hooks/usePrintMode';
 import { PageTemplateSchema } from '../../schemas/PageTemplateSchema';
 import { PrintConfigSchema } from '../../schemas/PrintConfigSchema';
 import { toCssLength } from '../../utils/cssUtils';
-import { useSafeLocation } from '../../utils/reactUtils';
+import { useNavigation } from '../../contexts/NavigationContext';
 import { SafeSpan } from '../SafeSpan';
 import './Page.css';
 import { Box } from '@mui/material';
@@ -275,7 +275,7 @@ export const PageView: React.FC<PageViewProps> = ({
   }, [isPrintMode, printConfig]);
 
   // Route (fallback to current location)
-  const location = useSafeLocation();
+  const { location } = useNavigation();
   const actualRoute = resolved.route || location?.pathname || '';
 
   // Context value

package/src/contexts/NavigationContext.tsx

@@ -0,0 +1,162 @@
+/**
+ * Navigation Context - Smart navigation that auto-detects React Router
+ *
+ * Provides navigation functions that work with React Router when available,
+ * falling back to window.location for non-router apps or SSR.
+ *
+ * Usage:
+ * - Wrap your app with NavigationProvider (done automatically by QwickApp)
+ * - Use useNavigation() hook to get navigate function and location
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+
+import { createContext, useContext, type ReactNode } from 'react';
+import {
+  useNavigate,
+  useLocation,
+  UNSAFE_NavigationContext as RouterContext,
+} from 'react-router-dom';
+
+/**
+ * Location type matching React Router's location shape
+ */
+export interface NavigationLocation {
+  pathname: string;
+  search: string;
+  hash: string;
+}
+
+/**
+ * Navigate function type
+ */
+export type NavigateFunction = (to: string | number) => void;
+
+/**
+ * Navigation context value
+ */
+export interface NavigationContextValue {
+  navigate: NavigateFunction;
+  location: NavigationLocation | undefined;
+}
+
+const NavigationContext = createContext<NavigationContextValue | null>(null);
+
+/**
+ * Internal provider that uses React Router hooks
+ * Only rendered when we're inside a Router context
+ */
+function ReactRouterNavigationProvider({ children }: { children: ReactNode }) {
+  const reactRouterNavigate = useNavigate();
+  const reactRouterLocation = useLocation();
+
+  const navigate: NavigateFunction = (to) => {
+    if (typeof to === 'string') {
+      reactRouterNavigate(to);
+    } else if (typeof to === 'number') {
+      reactRouterNavigate(to);
+    }
+  };
+
+  return (
+    <NavigationContext.Provider
+      value={{
+        navigate,
+        location: {
+          pathname: reactRouterLocation.pathname,
+          search: reactRouterLocation.search,
+          hash: reactRouterLocation.hash,
+        },
+      }}
+    >
+      {children}
+    </NavigationContext.Provider>
+  );
+}
+
+/**
+ * Internal provider that uses window.location fallback
+ * Used when not inside a React Router context
+ */
+function FallbackNavigationProvider({ children }: { children: ReactNode }) {
+  const navigate: NavigateFunction = (to) => {
+    if (typeof window === 'undefined') return;
+
+    if (typeof to === 'string') {
+      window.location.href = to;
+    } else if (typeof to === 'number') {
+      window.history.go(to);
+    }
+  };
+
+  const location: NavigationLocation | undefined =
+    typeof window !== 'undefined'
+      ? {
+          pathname: window.location.pathname,
+          search: window.location.search,
+          hash: window.location.hash,
+        }
+      : undefined;
+
+  return (
+    <NavigationContext.Provider value={{ navigate, location }}>
+      {children}
+    </NavigationContext.Provider>
+  );
+}
+
+/**
+ * Smart Navigation Provider
+ *
+ * Automatically detects if the app is inside a React Router context:
+ * - If inside Router: uses React Router's useNavigate/useLocation (respects basename)
+ * - If outside Router: falls back to window.location
+ *
+ * This is included automatically by QwickApp - you don't need to add it manually.
+ */
+export function NavigationProvider({ children }: { children: ReactNode }) {
+  // Check if we're inside a React Router by checking its internal context
+  // useContext doesn't throw - it returns null if the context doesn't exist
+  const routerContext = useContext(RouterContext);
+
+  if (routerContext) {
+    // We're inside a Router, use React Router's navigation
+    return (
+      <ReactRouterNavigationProvider>{children}</ReactRouterNavigationProvider>
+    );
+  }
+
+  // Not inside a Router, use window.location fallback
+  return <FallbackNavigationProvider>{children}</FallbackNavigationProvider>;
+}
+
+/**
+ * Hook to access navigation functions
+ *
+ * @returns Object containing navigate function and current location
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { navigate, location } = useNavigation();
+ *
+ *   const handleClick = () => {
+ *     navigate('/dashboard');
+ *   };
+ *
+ *   return <button onClick={handleClick}>Go to Dashboard</button>;
+ * }
+ * ```
+ */
+export function useNavigation(): NavigationContextValue {
+  const context = useContext(NavigationContext);
+
+  if (!context) {
+    throw new Error(
+      'useNavigation must be used within a NavigationProvider. ' +
+        'Make sure your component is wrapped in QwickApp or NavigationProvider.'
+    );
+  }
+
+  return context;
+}

package/src/contexts/index.ts

@@ -3,6 +3,8 @@ export { DataProvider, t, T, useData, useDataContext, useDataProvider, useResolv
 export type { DataProviderProps } from './DataContext';
 export { DimensionsProvider, useDimensions } from './DimensionsContext';
 export type { DimensionsContextValue, DimensionTokens } from './DimensionsContext';
+export { NavigationProvider, useNavigation } from './NavigationContext';
+export type { NavigateFunction, NavigationContextValue, NavigationLocation } from './NavigationContext';
 export { PaletteProvider, usePalette } from './PaletteContext';
 export type { PaletteConfig, PaletteContextValue } from './PaletteContext';
 export { ThemeProvider, useTheme } from './ThemeContext';

package/src/utils/iconMap.tsx

@@ -75,6 +75,7 @@ import {
   CheckCircle,
   RotateRight,
   Memory,
+  LocalOffer,
 } from '@mui/icons-material';
 
 /**
@@ -189,6 +190,7 @@ export const iconMap: Record<string, IconMapping> = {
   check_circle: { emoji: '✅', component: CheckCircle },
   rotate_right: { emoji: '🔄', component: RotateRight },
   memory: { emoji: '🧠', component: Memory },
+  local_offer: { emoji: '🏷️', component: LocalOffer },
 };
 
 /**

package/src/utils/reactUtils.tsx

@@ -7,55 +7,10 @@
 
 import { ReactNode } from 'react';
 
-/** Location type for routing */
-type LocationType = { pathname: string, search: string, hash: string };
-
-/**
- * Get the current location from browser or undefined in SSR
- * Works without relying on routing libraries
- * @returns {object | undefined} - The location object if in browser, otherwise undefined
- */
-export const useSafeLocation = (): LocationType | undefined => {
-  // Use browser location if available (works in any React app)
-  if (typeof window !== 'undefined') {
-    return {
-      pathname: window.location.pathname,
-      search: window.location.search,
-      hash: window.location.hash
-    };
-  }
-  return undefined;
-};
-
-/**
- * Navigate function type
- */
-export type NavigateFunction = (to: string | number, options?: unknown) => void;
-
-/**
- * Get a navigation function with fallback to window.location
- * Works without relying on routing libraries
- * @returns {NavigateFunction} - The navigate function
- */
-export const useSafeNavigate = (): NavigateFunction => {
-  // Return function that uses window.location
-  return (to: string | number) => {
-    if (typeof to === 'string') {
-      if (typeof window !== 'undefined') {
-        window.location.href = to;
-      }
-    } else if (typeof to === 'number') {
-      if (typeof window !== 'undefined' && window.history) {
-        window.history.go(to);
-      }
-    }
-  };
-};
-
 /**
  * Extract text content from ReactNode for code processing
  * Handles natural React usage like <Code>const x = 1;</Code>
- * 
+ *
  * @param node - The ReactNode to extract text from
  * @returns String representation of the node's text content
  */
@@ -73,7 +28,7 @@ export function extractTextFromReactNode(node: ReactNode): string {
   }
 
   if (Array.isArray(node)) {
-    return node.map(child => extractTextFromReactNode(child)).join('');
+    return node.map((child) => extractTextFromReactNode(child)).join('');
   }
 
   // For React elements, try to extract text content