@postxl/generators 0.2.2

package/dist/frontend-core/template/src/pages/error/default-error.page.tsx

@@ -0,0 +1,20 @@
+import { type ErrorComponentProps, Link } from '@tanstack/react-router'
+
+import { Button } from '@components/ui/button/button'
+
+export const DefaultErrorPage = ({ error }: { error: ErrorComponentProps }) => {
+  return (
+    <div className="flex w-full pt-4 px-4 h-(--content-without-header)">
+      <div className="flex flex-col gap-4 border-1 border-primary w-full h-full items-center justify-center">
+        <h2 className="text-center">
+          An unexpected error occurred:
+          <br />
+          {JSON.stringify(error, null, 2)}
+        </h2>
+        <Button asChild>
+          <Link to={'/'}>Back to Home</Link>
+        </Button>
+      </div>
+    </div>
+  )
+}

package/dist/frontend-core/template/src/pages/error/not-found-error.page.tsx

@@ -0,0 +1,17 @@
+import { Link, NotFoundError } from '@tanstack/react-router'
+
+import { Button } from '@components/ui/button/button'
+
+export const NotFoundErrorPage = ({ error }: { error: NotFoundError }) => {
+  console.log(error)
+  return (
+    <div className="flex w-full pt-4 px-4 h-(--content-without-header)">
+      <div className="flex flex-col gap-4 border-1 border-(--discreet-border) w-full h-full items-center justify-center">
+        <h2>The page you’re looking for doesn’t exist.</h2>
+        <Button asChild>
+          <Link to={'/'}>Back to Home</Link>
+        </Button>
+      </div>
+    </div>
+  )
+}

package/dist/frontend-core/template/src/pages/login/login.page.tsx

@@ -0,0 +1,50 @@
+import { useAuth } from '@context-providers/auth-context-provider'
+import { Route } from '@routes/login'
+
+import { useEffect } from 'react'
+
+import type { FileRouteTypes } from '../../routeTree.gen'
+
+/**
+ * Login component
+ *
+ * the auth check has to be implemented with an effect, because the keycloak.init is async
+ * so the isAuthenticated state is not available immediately at the "beforeLoad" option at the route level
+ * that's why our login component is a non-visual component, that just checks the auth state
+ * and redirects to the dashboard (landing page)
+ *
+ * - if authProvider is not initialized, it will wait for initializing complete
+ * - if the user is not authenticated, it will execute login (redirect to keycloak)
+ * - if the user is authenticated, it will wait for the user to be loaded (user !== null)
+ * - if the user is loaded, it will redirect to the dashboard
+ */
+export const LoginPage = () => {
+  const { isAuthenticated, isInitComplete, login, user } = useAuth()
+  const navigate = Route.useNavigate()
+  const searchParams = Route.useSearch()
+
+  useEffect(() => {
+    // wait for the keycloak init to complete
+    if (!isInitComplete) {
+      return
+    }
+
+    // if not authenticated yet, execute login
+    if (!isAuthenticated) {
+      void login() // NOSONAR
+    } else if (user) {
+      // if authenticated, redirect considering the user role
+      if (user.userRoles.includes('unauthorized')) {
+        void navigate({ to: '/unauthorized' }) // NOSONAR
+      } else {
+        // redirect, when the user is authenticated and loaded
+        const fallbackHome: FileRouteTypes['to'] = '/dashboard'
+        const href = searchParams.redirectUrl ?? fallbackHome
+        // for dev mode and HMR we need to wait for the redirect; otherwise the 'href' is not found by tanstack router
+        setTimeout(() => void navigate({ to: href, from: '/login' }), 0) // NOSONAR (we want to ignore the promise here)
+      }
+    }
+  }, [isAuthenticated, isInitComplete, login, navigate, searchParams.redirectUrl, user])
+
+  return <p>Login in progress...</p>
+}

package/dist/frontend-core/template/src/pages/root-document.tsx

@@ -0,0 +1,62 @@
+import { HeadContent, Outlet, Scripts } from '@tanstack/react-router'
+
+import { lazy, Suspense } from 'react'
+import { Toaster } from 'sonner'
+
+import { APP_CONFIG } from '@lib/config'
+
+const LazyDevtools = lazy(() =>
+  Promise.all([
+    import('@tanstack/react-devtools'),
+    import('@tanstack/react-query-devtools'),
+    import('@tanstack/react-router-devtools'),
+  ]).then(([{ TanStackDevtools }, { ReactQueryDevtoolsPanel }, { TanStackRouterDevtoolsPanel }]) => ({
+    default: () => (
+      <TanStackDevtools
+        config={{ position: 'bottom-left' }}
+        plugins={[
+          {
+            name: 'TanStack Query',
+            render: <ReactQueryDevtoolsPanel />,
+          },
+          {
+            name: 'TanStack Router',
+            render: <TanStackRouterDevtoolsPanel />,
+          },
+        ]}
+      />
+    ),
+  })),
+)
+
+export const RootDocument = () => {
+  return (
+    <>
+      {/* html header content */}
+      <HeadContent />
+
+      {/* page layout */}
+      <div className="flex flex-col min-h-screen w-full">
+        <Outlet />
+      </div>
+
+      {/* sonner toasts */}
+      <Toaster
+        richColors
+        position="bottom-right"
+        toastOptions={{
+          style: {
+            borderRadius: 'var(--radius)',
+          },
+        }}
+      />
+
+      {APP_CONFIG.enableDevTools && (
+        <Suspense>
+          <LazyDevtools />
+        </Suspense>
+      )}
+      <Scripts />
+    </>
+  )
+}

package/dist/frontend-core/template/src/pages/unauthorized/unauthorized.page.tsx

@@ -0,0 +1,12 @@
+import { useAuth } from '@context-providers/auth-context-provider'
+
+export const UnauthorizedPage = () => {
+  const { user } = useAuth()
+
+  return (
+    <section className="flex flex-col gap-4 border-1 color-border p-2 m-3 rounded">
+      <h1>Hi {user?.userDetails?.name}!</h1>
+      <p className="text-xl">You are not authorized to access this project.</p>
+    </section>
+  )
+}

package/dist/frontend-core/template/src/routes/__root.tsx

@@ -0,0 +1,79 @@
+import { AuthContext } from '@context-providers/auth-context-provider'
+import { RootDocument } from '@pages/root-document'
+import appCss from '@styles/styles.css?url'
+import { createRootRouteWithContext } from '@tanstack/react-router'
+
+import { z } from 'zod'
+
+type RouterContext = {
+  auth: AuthContext
+}
+
+const zSharedStateParams = z.object({
+  redirectUrl: z.string().optional(),
+})
+
+export type AppSearchParams = z.infer<typeof zSharedStateParams>
+
+/**
+ * all routes are rendered with auth context
+ */
+export const Route = createRootRouteWithContext<RouterContext>()({
+  head: () => ({
+    meta: [
+      {
+        charSet: 'utf-8',
+      },
+      {
+        name: 'viewport',
+        content: 'width=device-width, initial-scale=1',
+      },
+      {
+        name: 'robots',
+        content: 'noindex, nofollow',
+      },
+      {
+        title: '<%schema.name%>',
+      },
+      {
+        name: 'description',
+        content: '<%schema.name%>',
+      },
+    ],
+    links: [
+      {
+        rel: 'stylesheet',
+        href: appCss,
+      },
+      {
+        rel: 'icon',
+        type: 'image/png',
+        sizes: '16x16',
+        href: '/favicon-16x16.png',
+      },
+      {
+        rel: 'icon',
+        type: 'image/png',
+        sizes: '32x32',
+        href: '/favicon-32x32.png',
+      },
+      {
+        rel: 'apple-touch-icon',
+        type: 'image/png',
+        sizes: '180x180',
+        href: '/apple-touch-icon.png',
+      },
+      {
+        rel: 'icon',
+        type: 'image/x-icon',
+        href: '/favicon.ico',
+      },
+      {
+        rel: 'manifest',
+        href: '/site.webmanifest',
+      },
+    ],
+  }),
+  shellComponent: RootDocument,
+  validateSearch: zSharedStateParams,
+})

package/dist/frontend-core/template/src/routes/_auth-routes/dashboard.lazy.tsx

@@ -0,0 +1,6 @@
+import { DashboardPage } from '@pages/dashboard/dashboard.page'
+import { createLazyFileRoute } from '@tanstack/react-router'
+
+export const Route = createLazyFileRoute('/_auth-routes/dashboard')({
+  component: DashboardPage,
+})

package/dist/frontend-core/template/src/routes/_auth-routes.tsx

@@ -0,0 +1,19 @@
+import { createFileRoute, redirect } from '@tanstack/react-router'
+
+/**
+ * Auth Route Guard
+ * all routes that require authentication are rendered with auth context
+ * if the user is not authenticated, when accessing an auth-route, the redirect to the login page is executed
+ */
+export const Route = createFileRoute('/_auth-routes')({
+  beforeLoad: ({ context }) => {
+    const { isAuthenticated } = context.auth
+
+    if (!isAuthenticated) {
+      // store the redirect url as search param, if not authorized, to restore after keycloak login
+      throw redirect({ to: '/login', search: { redirectUrl: location.pathname + location.search } })
+    }
+
+    // if the user is authorized - do nothing (no redirect; required page is loaded)
+  },
+})

package/dist/frontend-core/template/src/routes/index.tsx

@@ -0,0 +1,8 @@
+import { createFileRoute, redirect } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/')({
+  beforeLoad: () => {
+    // our index route just redirects to the login page (to check the auth state of the user)
+    throw redirect({ to: '/login' })
+  },
+})

package/dist/frontend-core/template/src/routes/login.tsx

@@ -0,0 +1,6 @@
+import { LoginPage } from '@pages/login/login.page'
+import { createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/login')({
+  component: LoginPage,
+})

package/dist/frontend-core/template/src/routes/unauthorized.tsx

@@ -0,0 +1,6 @@
+import { UnauthorizedPage } from '@pages/unauthorized/unauthorized.page'
+import { createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/unauthorized')({
+  component: UnauthorizedPage,
+})

package/dist/frontend-core/template/src/stories/Configure.mdx

@@ -0,0 +1,363 @@
+import { Meta } from "@storybook/addon-docs/blocks";
+
+import Github from "./assets/github.svg";
+import Discord from "./assets/discord.svg";
+import Youtube from "./assets/youtube.svg";
+import Tutorials from "./assets/tutorials.svg";
+import Styling from "./assets/styling.png";
+import Context from "./assets/context.png";
+import Assets from "./assets/assets.png";
+import Docs from "./assets/docs.png";
+import Share from "./assets/share.png";
+import FigmaPlugin from "./assets/figma-plugin.png";
+import Testing from "./assets/testing.png";
+import Accessibility from "./assets/accessibility.png";
+import Theming from "./assets/theming.png";
+import AddonLibrary from "./assets/addon-library.png";
+
+export const RightArrow = () => <svg 
+    viewBox="0 0 14 14" 
+    width="8px" 
+    height="14px" 
+    style={{ 
+      marginLeft: '4px',
+      display: 'inline-block',
+      shapeRendering: 'inherit',
+      verticalAlign: 'middle',
+      fill: 'currentColor'
+    }}
+>
+  <path fill="currentColor" d="m11.1 7.35-5.5 5.5a.5.5 0 0 1-.7-.7L10.04 7 4.9 1.85a.5.5 0 1 1 .7-.7l5.5 5.5c.2.2.2.5 0 .7Z" />
+</svg>
+
+<Meta title="Configure your project" />
+
+<div className="sb-container">
+  <div className='sb-section-title'>
+    # Configure your project
+
+    Because Storybook works separately from your app, you'll need to configure it for your specific stack and setup. Below, explore guides for configuring Storybook with popular frameworks and tools. If you get stuck, learn how you can ask for help from our community.
+  </div>
+  <div className="sb-section">
+    <div className="sb-section-item">
+      <img
+        src={Styling}
+        alt="A wall of logos representing different styling technologies"
+      />
+      <h4 className="sb-section-item-heading">Add styling and CSS</h4>
+      <p className="sb-section-item-paragraph">Like with web applications, there are many ways to include CSS within Storybook. Learn more about setting up styling within Storybook.</p>
+      <a
+        href="https://storybook.js.org/docs/configure/styling-and-css/?renderer=react&ref=configure"
+        target="_blank"
+      >Learn more<RightArrow /></a>
+    </div>
+    <div className="sb-section-item">
+      <img
+        src={Context}
+        alt="An abstraction representing the composition of data for a component"
+      />
+      <h4 className="sb-section-item-heading">Provide context and mocking</h4>
+      <p className="sb-section-item-paragraph">Often when a story doesn't render, it's because your component is expecting a specific environment or context (like a theme provider) to be available.</p>
+      <a
+        href="https://storybook.js.org/docs/writing-stories/decorators/?renderer=react&ref=configure#context-for-mocking"
+        target="_blank"
+      >Learn more<RightArrow /></a>
+    </div>
+    <div className="sb-section-item">
+      <img src={Assets} alt="A representation of typography and image assets" />
+      <div>
+        <h4 className="sb-section-item-heading">Load assets and resources</h4>
+        <p className="sb-section-item-paragraph">To link static files (like fonts) to your projects and stories, use the
+        `staticDirs` configuration option to specify folders to load when
+        starting Storybook.</p>
+        <a
+          href="https://storybook.js.org/docs/configure/images-and-assets/?renderer=react&ref=configure"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+    </div>
+  </div>
+</div>
+<div className="sb-container">
+  <div className='sb-section-title'>
+    # Do more with Storybook
+
+    Now that you know the basics, let's explore other parts of Storybook that will improve your experience. This list is just to get you started. You can customise Storybook in many ways to fit your needs.
+  </div>
+
+  <div className="sb-section">
+    <div className="sb-features-grid">
+      <div className="sb-grid-item">
+        <img src={Docs} alt="A screenshot showing the autodocs tag being set, pointing a docs page being generated" />
+        <h4 className="sb-section-item-heading">Autodocs</h4>
+        <p className="sb-section-item-paragraph">Auto-generate living,
+          interactive reference documentation from your components and stories.</p>
+        <a
+          href="https://storybook.js.org/docs/writing-docs/autodocs/?renderer=react&ref=configure"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+      <div className="sb-grid-item">
+        <img src={Share} alt="A browser window showing a Storybook being published to a chromatic.com URL" />
+        <h4 className="sb-section-item-heading">Publish to Chromatic</h4>
+        <p className="sb-section-item-paragraph">Publish your Storybook to review and collaborate with your entire team.</p>
+        <a
+          href="https://storybook.js.org/docs/sharing/publish-storybook/?renderer=react&ref=configure#publish-storybook-with-chromatic"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+      <div className="sb-grid-item">
+        <img src={FigmaPlugin} alt="Windows showing the Storybook plugin in Figma" />
+        <h4 className="sb-section-item-heading">Figma Plugin</h4>
+        <p className="sb-section-item-paragraph">Embed your stories into Figma to cross-reference the design and live
+          implementation in one place.</p>
+        <a
+          href="https://storybook.js.org/docs/sharing/design-integrations/?renderer=react&ref=configure#embed-storybook-in-figma-with-the-plugin"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+      <div className="sb-grid-item">
+        <img src={Testing} alt="Screenshot of tests passing and failing" />
+        <h4 className="sb-section-item-heading">Testing</h4>
+        <p className="sb-section-item-paragraph">Use stories to test a component in all its variations, no matter how
+          complex.</p>
+        <a
+          href="https://storybook.js.org/docs/writing-tests/?renderer=react&ref=configure"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+      <div className="sb-grid-item">
+        <img src={Accessibility} alt="Screenshot of accessibility tests passing and failing" />
+        <h4 className="sb-section-item-heading">Accessibility</h4>
+        <p className="sb-section-item-paragraph">Automatically test your components for a11y issues as you develop.</p>
+        <a
+          href="https://storybook.js.org/docs/writing-tests/accessibility-testing/?renderer=react&ref=configure"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+      <div className="sb-grid-item">
+        <img src={Theming} alt="Screenshot of Storybook in light and dark mode" />
+        <h4 className="sb-section-item-heading">Theming</h4>
+        <p className="sb-section-item-paragraph">Theme Storybook's UI to personalize it to your project.</p>
+        <a
+          href="https://storybook.js.org/docs/configure/theming/?renderer=react&ref=configure"
+          target="_blank"
+        >Learn more<RightArrow /></a>
+      </div>
+    </div>
+  </div>
+</div>
+<div className='sb-addon'>
+  <div className='sb-addon-text'>
+    <h4>Addons</h4>
+    <p className="sb-section-item-paragraph">Integrate your tools with Storybook to connect workflows.</p>
+    <a
+        href="https://storybook.js.org/addons/?ref=configure"
+        target="_blank"
+      >Discover all addons<RightArrow /></a>
+  </div>
+  <div className='sb-addon-img'>
+    <img src={AddonLibrary} alt="Integrate your tools with Storybook to connect workflows." />
+  </div>
+</div>
+
+<div className="sb-section sb-socials">
+    <div className="sb-section-item">
+      <img src={Github} alt="Github logo" className="sb-explore-image"/>
+      Join our contributors building the future of UI development.
+
+      <a
+        href="https://github.com/storybookjs/storybook"
+        target="_blank"
+      >Star on GitHub<RightArrow /></a>
+    </div>
+    <div className="sb-section-item">
+      <img src={Discord} alt="Discord logo" className="sb-explore-image"/>
+      <div>
+        Get support and chat with frontend developers.
+
+        <a
+          href="https://discord.gg/storybook"
+          target="_blank"
+        >Join Discord server<RightArrow /></a>
+      </div>
+    </div>
+    <div className="sb-section-item">
+      <img src={Youtube} alt="Youtube logo" className="sb-explore-image"/>
+      <div>
+        Watch tutorials, feature previews and interviews.
+
+        <a
+          href="https://www.youtube.com/@chromaticui"
+          target="_blank"
+        >Watch on YouTube<RightArrow /></a>
+      </div>
+    </div>
+    <div className="sb-section-item">
+      <img src={Tutorials} alt="A book" className="sb-explore-image"/>
+      <p>Follow guided walkthroughs on for key workflows.</p>
+
+      <a
+          href="https://storybook.js.org/tutorials/?ref=configure"
+          target="_blank"
+        >Discover tutorials<RightArrow /></a>
+    </div>
+</div>
+
+<style>
+  {`
+  .sb-container {
+    margin-bottom: 48px;
+  }
+
+  .sb-section {
+    width: 100%;
+    display: flex;
+    flex-direction: row;
+    gap: 20px;
+  }
+
+  img {
+    object-fit: cover;
+  }
+
+  .sb-section-title {
+    margin-bottom: 32px;
+  }
+
+  .sb-section a:not(h1 a, h2 a, h3 a) {
+    font-size: 14px;
+  }
+
+  .sb-section-item, .sb-grid-item {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+  }
+
+  .sb-section-item-heading {
+    padding-top: 20px !important;
+    padding-bottom: 5px !important;
+    margin: 0 !important;
+  }
+  .sb-section-item-paragraph {
+    margin: 0;
+    padding-bottom: 10px;
+  }
+
+  .sb-chevron {
+    margin-left: 5px;
+  }
+
+  .sb-features-grid {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    grid-gap: 32px 20px;
+  }
+
+  .sb-socials {
+    display: grid;
+    grid-template-columns: repeat(4, 1fr);
+  }
+
+  .sb-socials p {
+    margin-bottom: 10px;
+  }
+
+  .sb-explore-image {
+    max-height: 32px;
+    align-self: flex-start;
+  }
+
+  .sb-addon {
+    width: 100%;
+    display: flex;
+    align-items: center;
+    position: relative;
+    background-color: #EEF3F8;
+    border-radius: 5px;
+    border: 1px solid rgba(0, 0, 0, 0.05);
+    background: #EEF3F8;
+    height: 180px;
+    margin-bottom: 48px;
+    overflow: hidden;
+  }
+
+  .sb-addon-text {
+    padding-left: 48px;
+    max-width: 240px;
+  }
+
+  .sb-addon-text h4 {
+    padding-top: 0px;
+  }
+
+  .sb-addon-img {
+    position: absolute;
+    left: 345px;
+    top: 0;
+    height: 100%;
+    width: 200%;
+    overflow: hidden;
+  }
+
+  .sb-addon-img img {
+    width: 650px;
+    transform: rotate(-15deg);
+    margin-left: 40px;
+    margin-top: -72px;
+    box-shadow: 0 0 1px rgba(255, 255, 255, 0);
+    backface-visibility: hidden;
+  }
+
+  @media screen and (max-width: 800px) {
+    .sb-addon-img {
+      left: 300px;
+    }
+  }
+
+  @media screen and (max-width: 600px) {
+    .sb-section {
+      flex-direction: column;
+    }
+
+    .sb-features-grid {
+      grid-template-columns: repeat(1, 1fr);
+    }
+
+    .sb-socials {
+      grid-template-columns: repeat(2, 1fr);
+    }
+
+    .sb-addon {
+      height: 280px;
+      align-items: flex-start;
+      padding-top: 32px;
+      overflow: hidden;
+    }
+
+    .sb-addon-text {
+      padding-left: 24px;
+    }
+
+    .sb-addon-img {
+      right: 0;
+      left: 0;
+      top: 130px;
+      bottom: 0;
+      overflow: hidden;
+      height: auto;
+      width: 124%;
+    }
+
+    .sb-addon-img img {
+      width: 1200px;
+      transform: rotate(-12deg);
+      margin-left: 0;
+      margin-top: 48px;
+      margin-bottom: -40px;
+      margin-left: -24px;
+    }
+  }
+  `}
+</style>

package/dist/frontend-core/template/src/stories/assets/accessibility.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="none" viewBox="0 0 48 48"><title>Accessibility</title><circle cx="24.334" cy="24" r="24" fill="#A849FF" fill-opacity=".3"/><path fill="#A470D5" fill-rule="evenodd" d="M27.8609 11.585C27.8609 9.59506 26.2497 7.99023 24.2519 7.99023C22.254 7.99023 20.6429 9.65925 20.6429 11.585C20.6429 13.575 22.254 15.1799 24.2519 15.1799C26.2497 15.1799 27.8609 13.575 27.8609 11.585ZM21.8922 22.6473C21.8467 23.9096 21.7901 25.4788 21.5897 26.2771C20.9853 29.0462 17.7348 36.3314 17.3325 37.2275C17.1891 37.4923 17.1077 37.7955 17.1077 38.1178C17.1077 39.1519 17.946 39.9902 18.9802 39.9902C19.6587 39.9902 20.253 39.6293 20.5814 39.0889L20.6429 38.9874L24.2841 31.22C24.2841 31.22 27.5529 37.9214 27.9238 38.6591C28.2948 39.3967 28.8709 39.9902 29.7168 39.9902C30.751 39.9902 31.5893 39.1519 31.5893 38.1178C31.5893 37.7951 31.3639 37.2265 31.3639 37.2265C30.9581 36.3258 27.698 29.0452 27.0938 26.2771C26.8975 25.4948 26.847 23.9722 26.8056 22.7236C26.7927 22.333 26.7806 21.9693 26.7653 21.6634C26.7008 21.214 27.0231 20.8289 27.4097 20.7005L35.3366 18.3253C36.3033 18.0685 36.8834 16.9773 36.6256 16.0144C36.3678 15.0515 35.2722 14.4737 34.3055 14.7305C34.3055 14.7305 26.8619 17.1057 24.2841 17.1057C21.7062 17.1057 14.456 14.7947 14.456 14.7947C13.4893 14.5379 12.3937 14.9873 12.0715 15.9502C11.7493 16.9131 12.3293 18.0044 13.3604 18.3253L21.2873 20.7005C21.674 20.8289 21.9318 21.214 21.9318 21.6634C21.9174 21.9493 21.9053 22.2857 21.8922 22.6473Z" clip-rule="evenodd"/></svg>