api-ref: custom API reference (#4770)
* initialized next.js project * finished markdown sections * added operation schema component * change page metadata * eslint fixes * fixes related to deployment * added response schema * resolve max stack issue * support for different property types * added support for property types * added loading for components * added more loading * type fixes * added oneOf type * removed console * fix replace with push * refactored everything * use static content for description * fixes and improvements * added code examples section * fix path name * optimizations * fixed tag navigation * add support for admin and store references * general enhancements * optimizations and fixes * fixes and enhancements * added search bar * loading enhancements * added loading * added code blocks * added margin top * add empty response text * fixed oneOf parameters * added path and query parameters * general fixes * added base path env variable * small fix for arrays * enhancements * design enhancements * general enhancements * fix isRequired * added enum values * enhancements * general fixes * general fixes * changed oas generation script * additions to the introduction section * added copy button for code + other enhancements * fix response code block * fix metadata * formatted store introduction * move sidebar logic to Tags component * added test env variables * fix code block bug * added loading animation * added expand param + loading * enhance operation loading * made responsive + improvements * added loading provider * fixed loading * adjustments for small devices * added sidebar label for endpoints * added feedback component * fixed analytics * general fixes * listen to scroll for other headings * added sample env file * update api ref files + support new fields * fix for external docs link * added new sections * fix last item in sidebar not showing * move docs content to www/docs * change redirect url * revert change * resolve build errors * configure rewrites * changed to environment variable url * revert changing environment variable name * add environment variable for API path * fix links * fix tailwind settings * remove vercel file * reconfigured api route * move api page under api * fix page metadata * fix external link in navigation bar * update api spec * updated api specs * fixed google lint error * add max-height on request samples * add padding before loading * fix for one of name * fix undefined types * general fixes * remove response schema example * redesigned navigation bar * redesigned sidebar * fixed up paddings * added feedback component + report issue * fixed up typography, padding, and general styling * redesigned code blocks * optimization * added error timeout * fixes * added indexing with algolia + fixes * fix errors with algolia script * redesign operation sections * fix heading scroll * design fixes * fix padding * fix padding + scroll issues * fix scroll issues * improve scroll performance * fixes for safari * optimization and fixes * fixes to docs + details animation * padding fixes for code block * added tab animation * fixed incorrect link * added selection styling * fix lint errors * redesigned details component * added detailed feedback form * api reference fixes * fix tabs * upgrade + fixes * updated documentation links * optimizations to sidebar items * fix spacing in sidebar item * optimizations and fixes * fix endpoint path styling * remove margin * final fixes * change margin on small devices * generated OAS * fixes for mobile * added feedback modal * optimize dark mode button * fixed color mode useeffect * minimize dom size * use new style system * radius and spacing design system * design fixes * fix eslint errors * added meta files * change cron schedule * fix docusaurus configurations * added operating system to feedback data * change content directory name * fixes to contribution guidelines * revert renaming content * added api-reference to documentation workflow * fixes for search * added dark mode + fixes * oas fixes * handle bugs * added code examples for clients * changed tooltip text * change authentication to card * change page title based on selected section * redesigned mobile navbar * fix icon colors * fix key colors * fix medusa-js installation command * change external regex in algolia * change changeset * fix padding on mobile * fix hydration error * update depedencies
This commit is contained in:
@@ -36,10 +36,10 @@ function CardContainer({
|
||||
href={href}
|
||||
className={clsx(
|
||||
"card",
|
||||
"tw-bg-medusa-bg-subtle dark:tw-bg-medusa-bg-base-dark",
|
||||
"tw-rounded tw-shadow-card-rest dark:tw-shadow-card-rest-dark",
|
||||
"tw-transition-all tw-duration-200 tw-ease-ease",
|
||||
"tw-flex tw-p-1 !tw-pb-1.5 tw-h-full",
|
||||
"bg-medusa-bg-subtle dark:bg-medusa-bg-base-dark",
|
||||
"rounded shadow-card-rest dark:shadow-card-rest-dark",
|
||||
"transition-all duration-200 ease-ease",
|
||||
"flex p-1 !pb-1.5 h-full",
|
||||
className
|
||||
)}
|
||||
>
|
||||
@@ -66,29 +66,26 @@ function CardLayout({
|
||||
className={clsx(
|
||||
containerClassName,
|
||||
!isSoon &&
|
||||
"hover:tw-bg-medusa-bg-subtle-hover dark:hover:tw-bg-medusa-bg-base-hover-dark",
|
||||
isSoon && "tw-pointer-events-none",
|
||||
"hover:bg-medusa-bg-subtle-hover dark:hover:bg-medusa-bg-base-hover-dark",
|
||||
isSoon && "pointer-events-none",
|
||||
isHighlighted &&
|
||||
"md:before:tw-content-[''] md:before:tw-absolute md:before:tw-top-0 before:tw-right-0 md:before:tw-w-1/2 md:before:tw-h-full md:before:tw-bg-no-repeat md:before:tw-bg-cover md:before:tw-bg-card-highlighted dark:md:before:tw-bg-card-highlighted-dark",
|
||||
!isSoon &&
|
||||
"hover:tw-shadow-card-hover dark:hover:tw-shadow-card-hover-dark"
|
||||
"md:before:content-[''] md:before:absolute md:before:top-0 before:right-0 md:before:w-1/2 md:before:h-full md:before:bg-no-repeat md:before:bg-cover md:before:bg-card-highlighted dark:md:before:bg-card-highlighted-dark",
|
||||
!isSoon && "hover:shadow-card-hover dark:hover:shadow-card-hover-dark"
|
||||
)}
|
||||
>
|
||||
<div
|
||||
className={clsx("tw-mb-1 tw-flex tw-justify-between tw-items-center")}
|
||||
>
|
||||
<div className={clsx("mb-1 flex justify-between items-center")}>
|
||||
{icon}
|
||||
{isSoon && <Badge variant={"purple"}>Guide coming soon</Badge>}
|
||||
{badge && <Badge {...badge} />}
|
||||
</div>
|
||||
<div className={clsx("tw-w-[calc(100%-20px)] [&>*:last-child]:tw-mb-0")}>
|
||||
<div className={clsx("w-[calc(100%-20px)] [&>*:last-child]:mb-0")}>
|
||||
<span
|
||||
className={clsx(
|
||||
"tw-text-label-regular-plus tw-text-medusa-text-base dark:tw-text-medusa-text-base-dark",
|
||||
"tw-mb-[4px] tw-block",
|
||||
"tw-transition-all tw-duration-200 tw-ease-ease",
|
||||
"text-compact-medium-plus text-medusa-fg-base dark:text-medusa-fg-base-dark",
|
||||
"mb-0.25 block",
|
||||
"transition-all duration-200 ease-ease",
|
||||
isSoon &&
|
||||
"group-hover:tw-text-medusa-text-disabled dark:group-hover:tw-text-medusa-text-disabled-dark"
|
||||
"group-hover:text-medusa-fg-disabled dark:group-hover:text-medusa-fg-disabled-dark"
|
||||
)}
|
||||
title={title}
|
||||
>
|
||||
@@ -97,11 +94,11 @@ function CardLayout({
|
||||
{description && (
|
||||
<p
|
||||
className={clsx(
|
||||
"tw-text-body-regular tw-text-medusa-text-subtle dark:tw-text-medusa-text-subtle-dark",
|
||||
"tw-transition-all tw-duration-200 tw-ease-ease",
|
||||
"text-medium text-medusa-fg-subtle dark:text-medusa-fg-subtle-dark",
|
||||
"transition-all duration-200 ease-ease",
|
||||
isSoon &&
|
||||
"group-hover:tw-text-medusa-text-disabled dark:group-hover:tw-text-medusa-text-disabled-dark",
|
||||
isHighlighted && "md:tw-w-1/2"
|
||||
"group-hover:text-medusa-fg-disabled dark:group-hover:text-medusa-fg-disabled-dark",
|
||||
isHighlighted && "md:w-1/2"
|
||||
)}
|
||||
title={description}
|
||||
>
|
||||
@@ -111,11 +108,11 @@ function CardLayout({
|
||||
{html && (
|
||||
<p
|
||||
className={clsx(
|
||||
"tw-text-label-regular tw-text-medusa-text-subtle dark:tw-text-medusa-text-subtle-dark",
|
||||
"tw-transition-all tw-duration-200 tw-ease-ease",
|
||||
"text-compact-medium text-medusa-fg-subtle dark:text-medusa-fg-subtle-dark",
|
||||
"transition-all duration-200 ease-ease",
|
||||
isSoon &&
|
||||
"group-hover:tw-text-medusa-text-disabled dark:group-hover:tw-text-medusa-text-disabled-dark",
|
||||
isHighlighted && "md:tw-w-1/2"
|
||||
"group-hover:text-medusa-fg-disabled dark:group-hover:text-medusa-fg-disabled-dark",
|
||||
isHighlighted && "md:w-1/2"
|
||||
)}
|
||||
dangerouslySetInnerHTML={{
|
||||
__html: html,
|
||||
@@ -135,8 +132,8 @@ function getCardIcon(item: ModifiedSidebarItem): JSX.Element {
|
||||
light: item.customProps.themedImage.light,
|
||||
dark: item.customProps.themedImage.dark,
|
||||
}}
|
||||
iconWrapperClassName={clsx("tw-p-[6px]")}
|
||||
iconClassName={clsx("tw-h-[20px] tw-w-[20px]")}
|
||||
iconWrapperClassName={clsx("p-[6px]")}
|
||||
iconClassName={clsx("h-[20px] w-[20px]")}
|
||||
/>
|
||||
)
|
||||
} else if (item.customProps?.image) {
|
||||
@@ -145,16 +142,16 @@ function getCardIcon(item: ModifiedSidebarItem): JSX.Element {
|
||||
icon={{
|
||||
light: item.customProps.image,
|
||||
}}
|
||||
iconWrapperClassName={clsx("tw-p-[6px]")}
|
||||
iconClassName={clsx("tw-h-[20px] tw-w-[20px]")}
|
||||
iconWrapperClassName={clsx("p-[6px]")}
|
||||
iconClassName={clsx("h-[20px] w-[20px]")}
|
||||
/>
|
||||
)
|
||||
} else if (item.customProps?.icon) {
|
||||
return (
|
||||
<BorderedIcon
|
||||
IconComponent={item.customProps.icon}
|
||||
iconWrapperClassName={clsx("tw-p-[6px]")}
|
||||
iconClassName={clsx("tw-h-[20px] tw-w-[20px]")}
|
||||
iconWrapperClassName={clsx("p-[6px]")}
|
||||
iconClassName={clsx("h-[20px] w-[20px]")}
|
||||
/>
|
||||
)
|
||||
} else if (
|
||||
@@ -164,8 +161,8 @@ function getCardIcon(item: ModifiedSidebarItem): JSX.Element {
|
||||
return (
|
||||
<BorderedIcon
|
||||
IconComponent={Icons[item.customProps?.iconName]}
|
||||
iconWrapperClassName={clsx("tw-p-[6px]")}
|
||||
iconClassName={clsx("tw-h-[20px] tw-w-[20px]")}
|
||||
iconWrapperClassName={clsx("p-[6px]")}
|
||||
iconClassName={clsx("h-[20px] w-[20px]")}
|
||||
/>
|
||||
)
|
||||
} else {
|
||||
|
||||
Reference in New Issue
Block a user