Developer portal changelog

attention

This changelog is divided into two tracks:

1 - for 1.1.x releases

2 - for 1.0.x releases

Developer portal 1.1.x

1.1.0-beta.44 (2021-09-13)

Fixes

  • Resolved a layout issue that appeared in landscape mode on iPhone X devices.

1.1.0-beta.43 (2021-09-09)

Features

Fixes

  • Resolve partially corrected issue with the colorette dependency from the previous release.

1.1.0-beta.42 (2021-09-08)

Features

Fixes

  • Resolved an issue with the broken colorette dependency that would cause a crash after updating yarn.lock.

1.1.0-beta.41 (2021-09-02)

Fixes

  • Resolved an issue with RBAC portals crashing post-build because of invalid pages: null values in the sidebar.
  • Resolved an issue with crashed RBAC portal builds not reported as failed.

1.1.0-beta.40 (2021-08-31)

Features


1.1.0-beta.39 (2021-08-30)

Features

  • Customers who use our Apigee integration will notice the App page has been fully redesigned, and now includes more detailed information on the API key status.

1.1.0-beta.38 (2021-08-26)

Features

  • Upgraded the Reference docs package to 2.1.2 - check the Reference docs changelog for details about this version.
  • Implemented support for custom sanitize hooks in overrides.

Fixes

  • Resolved an issue with logoutUrl.

1.1.0-beta.37 (2021-08-25)

Features

  • User claims and idpId are now supported in the login hook.

1.1.0-beta.36 (2021-08-20)

Features

Fixes

  • Fixed a typo in the build error message displayed when a snippet file is not found.
  • Resolved a styling issue with portal search results that were displayed in white text on a white background.
  • Resolved an issue with hook ordering that caused crashes for some customers.

1.1.0-beta.35 (2021-08-18)

Features

  • You can now use the LoginMenu component in custom overrides; for example, when you want to override the navbar but still use the default login menu.
  • A new hook called OnPagination is now supported for integrated Reference docs, and runs on pagination between Reference docs pages.
  • Upgraded the Reference docs package to 2.0.14 - check the Reference docs changelog for details about this version.

1.1.0-beta.34 (2021-08-17)

Features


1.1.0-beta.33 (2021-08-17)

Features

  • Upgraded the Reference docs package to 2.0.12 which fixes the issue with enum values not displaying properly, among other improvements. Check the Reference docs changelog for details about this version.

1.1.0-beta.32 (2021-08-16)

Features

  • Implemented basic support for the x-meta specification extension for integrated Reference docs. Add it to your API definition on the operation level to control meta tags for each page (operation). The prerequisite is that your Reference docs has pagination: item configured. Here is a basic example of the x-meta syntax:
x-meta:
  title: title
  description: descr
  keywords: test1, test2
  image: https://
  • Upgraded the Reference docs package to 2.0.11 and implemented all fixes to integrated Reference docs. Check the Reference docs changelog for details about this version.

1.1.0-beta.31 (2021-08-13)

Features

  • When users search for information in your developer portal, the results will now be more accurate thanks to improved search weights. More specifically, pages with titles that match the search query will now appear higher in the list of results than the pages that only match the query in the text body.

Fixes

  • Resolved an issue with the order of React hooks that could crash on Reference docs pages in the portal.

1.1.0-beta.30 (2021-08-11)

Features

Fixes

  • Resolved an issue with the Ctrl+F browser search override not working on Reference docs pages in the portal.
  • Resolved an issue with the Link React component that would cause a circular import crash when used in a specific way with _override.
  • Resolved an issue with an extra path prefix in unauthorizedTryIt.link.

1.1.0-beta.29 (2021-08-10)

Fixes

  • Improved the order of search results so that more accurate results are displayed first.
  • Resolved an issue with the login menu not showing up for some users.
  • Resolved an issue with protected registry URLs that were not working correctly.

1.1.0-beta.28 (2021-08-06)

Features

This major Developer portal release introduces support for Reference docs 2.0 and brings a complete visual overhaul to your integrated API reference docs.

It also introduces:

  • major changes to the Button React component usage
  • the latest version of the openapi-cli package

For the full list of changes and upgrade instructions, make sure to read the migration guide.

How to roll back to the old Reference docs design?

Developer portal users can downgrade their portal version to 1.0.0-beta.162 to use the old Reference docs design.

1.1.0-beta.1 - 1.1.0-beta.27

Internal releases.


Developer portal 1.0.x

1.0.0-beta.166 (2021-09-09)

Fixes

  • Backported a tty fix from the 1.1.0-beta.x release channel.

1.0.0-beta.165 (2021-08-26)

Internal changes.


1.0.0-beta.164 (2021-08-12)

Features

  • When users search for information in your developer portal, the results will now be more accurate thanks to improved search weights. More specifically, pages with titles that match the search query will now appear higher in the list of results than the pages that only match the query in the text body.

1.0.0-beta.163 (2021-08-10)

Internal release.


1.0.0-beta.162 (2021-08-03)

Features

  • You can now set the lang property for your portal to indicate the language of your content. To set it globally for the entire portal, add it to the meta section of the siteConfig.yaml file. You can also override the global setting for individual pages by setting it in the page front matter.
  • The developer portal theme now supports a new margin option in the logo section. To configure it, you can use one value (applies the same margin to all sides of the image) or specify up to four separate values. The values must follow the standard CSS margin property syntax.

Fixes

  • Resolved an issue with custom data loss when using createTemplatePage inside createPages caused by the sourcePath hook.
  • Resolved an issue with portal builds crashing when Markdown-style image formatting was used in MDX pages.

1.0.0-beta.161 (2021-07-28)

Features

  • The logo image displayed in the portal navbar can now have custom alt text. To add it, use the logoAltText option in the meta section of the siteConfig.yaml file.

1.0.0-beta.160 (2021-07-20)

Fixes

  • Resolved a Windows issue with custom CSS imports and images in Markdown snippets.

1.0.0-beta.159 (2021-07-08)

Fixes

  • Resolved an issue with processing .sample.js imports.

1.0.0-beta.158 (2021-07-07)

Fixes

  • Resolved an issue with broken absolute links in reusable snippets.

1.0.0-beta.157 (2021-07-02)

Features

  • You can now import raw code samples from standalone files into MDX pages. The approach is similar to how you would import a React component. Save your code sample as a file in your portal project with the .sample.ext extension, where ext matches the code language extension (py, js...). Then, import it at the beginning of your MDX page and insert it in the page body like in this example:
import codeSample from './code-samples/code.sample.js';

# Page title

Page text

## Example section with code sample

<pre><code>{codeSample}</code></pre>

Fixes

  • Resolved an issue with local CSS stylesheets not working for some Windows users.
  • Improved the approach to calculating the last modified date for pages. Additionally, lastModified is now available through pageContext globally.

1.0.0-beta.156 (2021-06-23)

Fixes

  • Resolved issues caused by a conflicting dependency.

1.0.0-beta.155 (2021-06-23)

Fixes

  • Resolved a version compatibility issue with the gatsby-remark-image-attributes plugin.

1.0.0-beta.154 (2021-06-22)

Fixes

  • Upgraded the Reference docs package to the latest version (1.5.13).
  • Resolved an issue that prevented the Try it console in integrated Reference docs from functioning properly.

1.0.0-beta.153 (2021-06-18)

Fixes

  • Improved the print CSS stylesheets and removed the portal navbar from the print layout.
  • Resolved a regular expression issue in the Apigee integration.

1.0.0-beta.152 (2021-06-17)

Features

  • Improved support for Markdown snippets makes it possible to use admonitions, links, images and code blocks in your reusable snippet files. Snippets are no longer limited only to Markdown target pages - you can now use them in MDX pages as well.

Fixes

  • Resolved a URL-encoding issue with developer email addresses for the Apigee integration that contain the + symbol.

1.0.0-beta.151 (2021-06-17)

Features

  • When inserting images into your Markdown pages, you can now specify their size. Supported image size parameters are width and height, and you can set both or just one for each image. The following example illustrates how to insert a resized image:

![Description of a resized image](./path/to/image.png#width=500px;height:350px;)


1.0.0-beta.150 (2021-06-16)

Fixes

  • Resolved an issue with illegible content in the JsonSchema component caused by a dark background.

1.0.0-beta.149 (2021-06-15)

Features

  • Developer portal pages are now more printer-friendly thanks to improvements to the print CSS stylesheet.

1.0.0-beta.148 (2021-06-11)

Features

  • The login component in the portal navbar now supports redirecting to a custom URL after users log out of the portal. You can set the custom URL in the login.menu section of the siteConfig.yaml file. Refer to the login component documentation for more details.

Fixes

  • Resolved an issue with inconsistent dependencies that crashed the build after performing a clean install of the portal.

1.0.0-beta.147 (2021-06-07)

Fixes

  • Automatic exclusion of the top-level README.md file now works as intended. If your portal has this file in the root of the project, it will now be automatically excluded from the portal build and from search.

1.0.0-beta.146 (2021-05-31)

Fixes

  • Resolved an issue with the search functionality that prevented the search results from including all scopes.

1.0.0-beta.145 (2021-05-27)

Features

  • Implemented support for controlling access to portal sidebars with RBAC.

Fixes

  • Long headings in MD(X) page table of contents will now automatically wrap when they exceed the width of the page.

1.0.0-beta.144 (2021-05-25)

Features

  • The Developer portal sidebar now supports a new configuration option - selectFirstItemOnExpand - to control the behavior of group items. When this option is set to true, selecting the group name in the sidebar automatically activates the first item in the group. When using this option, you must not add the page option to the same group.

Fixes

  • Resolved an issue with circular references preventing the MenuItem override from importing the original MenuItem and decorating it.
  • Upgraded the @redocly/reference-docs library to version 1.5.5.

1.0.0-beta.143 (2021-05-20)

Features

  • Upgraded the @redocly/reference-docs library to version 1.5.4. Check the Reference docs changelog for details on what's new in that version.

Fixes

  • Resolved an issue with the login button using an invalid pathPrefix which affected the login page URL in build previews.
  • Inline code in MD(X) pages now wraps properly and no longer exceeds the width of the containing element.

1.0.0-beta.142 (2021-05-18)

Features

  • If the content on your portal is protected behind a login, you can now set up the login component without having to implement custom overrides. Define the settings for your login button and menu in the siteConfig.yaml file, then customize the user avatar in the components > login section of the theme.ts file. Note that the login component is disabled by default, and that it requires you to configure login and authentication settings for the portal.
  • The portal now supports a login page in local development mode, making it easier to simulate the login process for debugging purposes.
  • The following Apigee page components are now built into the portal and can be imported from @redocly/developer-portal/apigee:

    • AppPage
    • AppsPage
    • CreateAppPage

Check the developer portal starter repository for an example, and refer to our Apigee integration documentation to understand how Apigee works with Redocly Developer portal.


1.0.0-beta.141 (2021-05-12)

Features

  • You can now integrate Google Global Site Tag into your developer portal. When configured, this integration works only in production, not in local development mode. Check our siteConfig.yaml documentation for instructions on how to set it up.
  • Developer portal now supports overriding the global App wrapper to set a custom global context. The override should be created as a new file _override/App.tsx, and the portal must be restarted after saving the file to apply the changes.
  • The usePageData helper can now return pageId (an internal portal page ID) and the page frontmatter object (if applicable).

Deprecated

  • The package @redocly/ui is now deprecated. From this version forward, use @redocly/developer-portal/ui instead.

1.0.0-beta.140 (2021-05-11)

Fixes

  • Resolved an issue with old versions of the yaml module that could happen when upgrading the portal without removing the .lock file.
  • Resolved an issue with builds breaking for portals that use the JsonSchema component after upgrading to the 1.0.0-beta.139 version.
  • Implemented the improvements from Reference docs 1.5.1.

1.0.0-beta.139 (2021-05-07)

Features

  • We have improved the organization of the main portal configuration file, siteConfig.yaml. All analytics integrations are now configured under the top-level analytics key. Compare the old and the new configuration syntax:
- ga:
-   trackingId: your-google-analytics-tracking-id
- googleTagManager:
-   id: your-google-tag-manager-id
-
+ analytics:
+   ga:
+     trackingId: your-google-analytics-tracking-id
+   googleTagManager:
+     id: your-google-tag-manager-id
+

Although the old configuration syntax still works, it displays warnings in the log, so we recommend switching to the new one.

  • You can now integrate FullStory analytics into your developer portal. When configured, this integration works only in production, not in local development mode. Set it up in your siteConfig.yaml file like in the following example:
analytics:
  fullstory:
    fs_org: YOUR_ORG_ID

Deprecated

  • The headerIcon option in the siteConfig.yaml configuration file has been deprecated. Use logo instead to set the path to your portal logo.

Fixes

  • Resolved an issue with the hideInfoSection: true not working in integrated Reference docs pages.

1.0.0-beta.138 (2021-04-29)

Features

  • Rich metadata images are now supported in the front matter of MD(X) pages. Add image: /path/to/image-file to the front matter of a page to set up its preview image. This image is displayed when sharing the link to the page on social media.
  • You can now set the contents of the <meta name="keywords"> tag in your portal. Provide the keywords as a comma-separated list, e.g. keywords: documentation, api, openapi in the meta section of the siteConfig.yaml file. You can also override the site-wide keywords and set them in the front matter of each individual MD(X) page.
  • At last, the developer portal theme lets you style buttons. You can change the font weight and font family of the button text, control button shadowing and hover behavior, and set the border radius for the button element. All these options should be set in the components > buttons section of your theme.ts file. Additionally, we have improved the overall default appearance of buttons in the portal, and made their font sizes and shadows more consistent.

Fixes

  • Resolved an issue related to Next/Back buttons when RBAC is enabled in the portal.

1.0.0-beta.137 (2021-04-29)

Broken release.


1.0.0-beta.136 (2021-04-22)

Fixes

  • Resolved an issue with the wrong core-js import that was crashing the tests for some of our customers.

1.0.0-beta.135 (2021-04-19)

Features

  • To improve the navigation in your developer portal, you can now enable the "Back to" button on MD(X) pages. To enable the button site-wide, for all pages at once, add showPrevButton: true to the siteConfig.yaml file. Alternatively, enable it only on specific pages by adding showPrevButton: true to the page front matter.
  • If you reference any files (such as images or Markdown pages) in the front matter of your MD(X) files, those files will now be copied to the static folder in the portal. References to those files will be automatically replaced by their destination links.

Fixes

  • Resolved an issue with require images caused by the upgrade to Gatsby v3.

1.0.0-beta.134 (2021-04-15)

Features

  • The portal can now use top-level context to pass the current API definition down to components. This allows users to import the context (as import {usePageData} from '@redocly/developer-portal/ui') and use it in their own custom components (as const {rawApiDefinition} = usePageData();).

Fixes

  • Removed the old version of the API Overview page in integrated Reference docs and implemented support for the new one.
  • After logout, the portal now redirects to a path with a trailing slash.
  • Definition IDs with dashes (e.g. api-main) now work properly with components that require definitionId, such as OpenApiExample or OpenApiRequestBody.
  • Resolved an issue where long group sublabels in drilldown sidebar style would overflow the sidebar width.
  • Resolved an issue with the portal navbar not taking the full screen width and displaying gaps on the sides.
  • Resolved an issue with incorrect paths for the Reference docs license key on Windows.

1.0.0-beta.133 (2021-04-15)

Broken release.


1.0.0-beta.132 (2021-04-13)

Fixes

  • Resolved an issue with RBAC where menu item permissions in the sidebar were lost for pages added using the /* pattern.

1.0.0-beta.131 (2021-04-13)

Features

  • We have migrated the Developer portal to Gatsby v3, updated all outdated dependencies, and resolved security warnings.
warning

To upgrade your portal to this version, first remove yarn.lock, then run yarn clean, followed by yarn install.

Fixes

  • Checkboxes for oAuth2 scopes in the clientCredentials flow are now properly rendered in the Reference docs Try it console.

1.0.0-beta.130 (2021-04-07)

Fixes

  • Resolved an issue with the search index not working for partial operation path fragments (e.g. in user/findById, the findById part was not searchable).
  • Improved the custom login functionality for multiple identity providers. This is supported only in developer portals hosted on-premise.

1.0.0-beta.129 (2021-04-06)

Fixes

  • Resolved an issue with the sidebar and the Try it console scrolling under the navigation bar in some cases.
  • Resolved an issue with auth section links pointing to an invalid URL when using the index.page.yaml file in the root of the portal.

1.0.0-beta.128 (2021-04-02)

Fixes

  • Resolved an issue with the Reference docs version switcher not working correctly for operations without a tag and the overview page.
  • OAS definitions errors are now displayed in the terminal output.
  • Improved page scrolling handlers to optimize performance.

1.0.0-beta.127 (2021-03-31)

Features

  • The rightPanel > width theming option can now accept the CSS calc function as a value.

1.0.0-beta.126 (2021-03-31)

Features

  • The rightPanel > width theming option now supports media query values, allowing you to customize it depending on the screen size (example: rightPanel: { width: { medium: '40%', large: '800px'}}).
  • The typography > links section of the Developer portal theme now lets you customize the textDecoration value.
  • The pageId is now passed to custom Markdown template properties.

Fixes

  • Pinned the version of the informed library to prevent an infinite loop when opening the Try it console in Reference docs.

1.0.0-beta.125 (2021-03-29)

Fixes

  • Resolved an issue with RBAC not working for portals hosted in Workflows when the auth section was omitted from the siteConfig.yaml file.

1.0.0-beta.123 (2021-03-27)

Features

  • You can now customize the width and padding of the main content wrapper (the area containing the text from your MD(X) pages). This is done by modifying the values in the contentWrapper section of your portal theme.ts file:
components:
  contentWrapper: {
    maxWidth: '910px',
    paddingHorizontal: '0',
    paddingVertical: '40px',
  },

Fixes

  • Resolved an issue with the incorrect default maxWidth value of the main content wrapper element.

1.0.0-beta.122 (2021-03-27)

Features

  • You can now customize the values for marginTop, marginBottom, marginLeft and marginRight in the developer portal theme.ts file for all heading levels (H1 to H6). Here is an example for H2:
heading2: {
    fontSize: '1.50em',
    fontWeight: '600',
    color: '#000000',
    capitalize: false,
    marginTop: '1.25em',
    marginBottom: '0.8em',
},
  • The developer portal now allows you to define the value of theming options as a breakpoints object. When configured in this way, theming options are used according to the breakpoints specified in the theme, ensuring your portal looks great at any screen size.

Here is an example excerpt from the theme.ts file showing how to define a breakpoints object for typography.fontSize:

  breakpoints: {
    small: '320px',
    medium: '720px',
    large: '1280px',
  },
  typography: {
    fontSize: { _: '36px', small: '42px', medium: '52px', large: '60px' },
    lineHeight: '1.6'
  }

In this example, the font size of 42 px is used only on small screen sizes. Values configured as strings (like lineHeight in the example) are used on all screen sizes. The special breakpoint _ cannot be manually set in the breakpoints section of the theme, but you should use it in all breakpoints objects. It defines the value for the smallest screen sizes (0 to "small"). If you don't specify it, the default theme value will be used instead.

The following theming options now support the breakpoints object as the value (in addition to previously supported string values):

typography:
    fontFamily,
    fontSize,
    lineHeight,
    code:
        fontFamily,
        fontSize
    headings:
        fontFamily,
        lineHeight
    heading1 to heading6:
        fontFamily,
        fontSize,
        lineHeight,
        marginBottom,
        marginLeft,
        marginRight,
        marginTop,
        marginHorizontal,
        marginVertical
    rightPanelHeading:
        fontFamily,
        fontSize,
        lineHeight
    fieldName:
        fontFamily,
        fontSize,
        lineHeight
schema:
    constraints:
        fontFamily,
        fontSize,
        lineHeight
    examples:
        fontFamily,
        fontSize,
        lineHeight
sidebar:
    fontFamily
codeBlock:
    tokens:
        default:
            fontFamily,
            fontSize,
            lineHeight
  • A new theming option showAtBreakpoint is supported in the rightPanel section of the theme.ts file. Use this option to control the starting screen size at which the right panel will become visible in Reference docs pages. Its value must be a string, and it must match one of the breakpoints defined in the theme.

Example

rightPanel: {
    backgroundColor: 'red',
    textColor: '#000000',
    showAtBreakpoint: 'medium'
    }

Fixes

  • 301 redirects are now supported and will be functional in build previews for developer portals hosted in Redocly Workflows.
  • Removed the linear gradient when the bgImage property is used with the Jumbotron component.

1.0.0-beta.121 (2021-03-23)

Features

  • A new type of alert (or admonition) called info is now supported in Markdown files. Read more about using admonitions.
  • You can now customize all types of alerts directly in the developer portal theme. New theming options cover font and color changes, including the option to set custom icons for alert boxes.
  • Speaking of custom icons, you can now change the default icon used in the search bar (when search is enabled in your portal). Override the default icon with another one of your choice, or just modify its color. These options must be set in the developer portal theme.
  • Blockquotes now support additional styling options in the developer portal theme.

Fixes

  • Internal links are now handled client-side and no longer trigger a full page reload.
  • Resolved an issue with the logout helper function redirecting to a wrong location when the portal was built with --prefix-paths.
  • Text formatted as inline code now properly supports line breaks and will no longer overflow the page width.
  • Removed excessive top margin from the content wrapper.
  • The icons in alert boxes (also known as admonitions) are now centered in relation to the text, and their appearance has been improved to make them stand out.

1.0.0-beta.120 (2021-03-19)

Features

  • You can now disable Sharp-based image optimization for your developer portal by setting disableImagesOptimization: true in the siteConfig.yaml file. Sharp is now an optional dependency in the portal installation, so if it fails to install for any reason, the portal will continue to work.
  • Image optimization is now disabled by default in portal development mode. To enable it in your local development server:

    • either add the --with-images-optimization flag to the start command in package.json,
    • or run the server with yarn start --with-images-optimization.

1.0.0-beta.119 (2021-03-18)

Features

  • A new front matter option redirectFrom is now supported in MD(X) pages. Use this option to define a list of one or more URLs. This will create meta-refresh redirects from all listed URLs to your page when building the portal.

Fixes

  • Resolved several minor issues with search indexing for integrated Reference docs with pagination set to item or section.

1.0.0-beta.118 (2021-03-18)

Features

  • Markdown files now support simpler, more convenient syntax for admonitions (warnings, notes, tips...). You can use these admonition types: info, success, warning, danger, attention - read the documentation for more details. Here's a comparison of the old and the new syntax:
- <div class="warning"><b>Optional title</b>
-
- Some warning text
-
- </div>
+ :::warning Optional title
+
+ Some warning text
+
+ :::

Fixes

  • The search functionality now works for integrated Reference docs when pagination is set to item or section.

1.0.0-beta.117 (2021-03-16)

Features

  • New, simplified pagination options for Reference docs are now supported in the Developer portal. The behavior and settings for paginated Reference docs in the portal are now consistent with that of standalone Reference docs. Find more details on new defaults and how to adjust them in the Migration guide section.
  • A new configuration option hideInfoDescription is now supported in .page.yaml files for finer control over the integrated Reference docs content.

Deprecated

  • When integrating Reference docs into your portal, do not use the following options in .page.yaml file(s), as they are no longer supported:

    • expand
    • includeSections
    • showInfo
  • When declaring the type for integrated Reference docs in .page.yaml file(s), set it as type: reference-docs. Setting it as type: redoc is no longer supported.

Migration guide

After upgrading to Developer portal 1.0.0-beta.117, you may notice some changes in your integrated Reference docs. You may also need to modify the configuration options in your .page.yaml files.

Here's a list of changes and new defaults you may want to adjust:

  • Build logs will show warnings for the type: redoc value in your .page.yaml file(s). Change it to type: reference-docs.
  • The showInfo option is no longer supported in .page.yaml files. The functionality of showInfo: true is now the default, so you can remove it from .page.yaml. To replace the functionality of showInfo: false, add hideInfoSection: true under settings.
type: reference-docs
definitionId: example
settings:
  hideInfoSection: true
  • By default, your integrated Reference docs now have an API overview page like the standalone Reference docs, with basic information about the API and the Download button. This page has its own menu item in the sidebar, and uses the info.title value from the API definition as the default item name. To set a custom menu item name, use the label option in the .page.yaml file. To hide the Download button on the API overview page, add hideDownloadButton: true under settings. To hide the entire API overview page and its menu item in the sidebar, add hideInfoSection: true under settings.
  • The expand option is no longer supported in .page.yaml files. To replace the functionality of expand: false, add pagination: none under settings in your .page.yaml file, then include that .page.yaml file in sidebars.yaml as follows:
exampleSidebar:
 - page: openapi/reference.page.yaml/*
 - page: other-example-page.md

To replace the functionality of expand: true, add either pagination: item or pagination: section under settings˙.

  • The includeSections option is no longer supported in .page.yaml files. To replace the functionality of includeSections: false, add hideInfoDescription: true under settings. The functionality of includeSections: true is now the default, so you can remove it from .page.yaml.
  • Markdown sections from your API definition info.description are now displayed by default. To hide them, add hideInfoDescription: true under settings. This does not hide the entire info section.
  • The authentication section is added by default to your info.description sections. To hide it, add noAutoAuth: true under settings.

In summary, consider adding these settings to hide content that's now visible by default:

settings:
  hideInfoSection: true
  hideInfoDescription: true
  hideDownloadButton: true
  noAutoAuth: true

Fixes


1.0.0-beta.116 (2021-03-11)

Features

Fixes

  • The version switcher sticks to the the top of the sidebar.
  • Fixed group expand/collapse behavior for specific cases.
  • Fixed inconsistent spacing when groups and pages are at the same level.

1.0.0-beta.115 (2021-03-10)

Features

  • In addition to previously supported relative links (../guides/example.md), your links to MD(X) files can now be absolute (/guides/example.md) from the root of the Developer portal. This gives you more freedom when linking your content.
  • The version switcher element for quick navigation between multiple API documentation versions is now supported in the Developer portal. To enable it for integrated Reference docs in your portal, list the versions you want to display in the .page.yaml file(s). Read more in the reference docs integration.

1.0.0-beta.114 (2021-03-10)

1.0.0-beta.113 (2021-03-10)

Broken releases.


1.0.0-beta.112 (2021-03-04)

Features

  • Redocly Developer portal now sports a freshly redesigned sidebar. It's not just about the looks, either - several sidebar theming and configuration options are now available. For example, you can add a custom icon and custom description text to sidebar groups when using the drilldown sidebar style. A new type of separator - horizontal divider line - is also supported, and can be added to the sidebar as separatorLine: true. New theming options make it possible to change the sidebar background color, font family and size, separator color, and control the spacing of items. Read more on how to customize the portal sidebar in the documentation.

Updating to this version of Developer portal will automatically change the visual style of your portal sidebar, but it will not change your sidebars.yaml file contents.

To revert to the old sidebar style, you must either downgrade your Developer portal to an older version or override the sidebar. A basic override example is available in the developer portal starter repository.

Fixes


1.0.0-beta.111 (2021-03-03)

Features

  • The Next to navigation button visible at the bottom right of portal pages can now be hidden. You can disable it for the entire developer portal by setting showNextButton to false in the siteConfig.yaml file. Alternatively, hide it for each individual page by setting showNextButton: false in the front matter of your MD(X) files.
  • Canonical URLs are now supported in the developer portal. To enable this, set a value for siteUrl in the meta section of your siteConfig.yaml file (for example, siteUrl: 'https://www.example.com'). This value will be used as the base URL for canonical links, and rel="canonical" will be automatically added to the head of all HTML pages in your portal.

1.0.0-beta.110 (2021-02-24)

Features

  • A new helper function called usePathPrefix is now available and can be imported from @redocly/ui.
  • A new front matter option exclude is now supported on MD and MDX pages. Use it to exclude an entire page from the portal build by adding exclude: true to the page front matter.
  • The WideTile component now supports the maxWidth property. You can configure the property as a percentage or as an exact amount of pixels.

Fixes

  • Issues with the Reference docs configuration option showRightPanelToggle have been resolved.
  • Tile components now properly support mailto: links.
  • If your developer portal project contains a top-level README.md file, this file will now be excluded from the portal build.
  • When using the WideTile component that contains an icon, the icon and the content will now be aligned to the top of the tile element instead of to the center.

1.0.0-beta.109 (2021-02-16)

Features

  • Implemented support for multiple identity providers in the on-premise Docker container. Identity providers can be configured in the auth section of the siteConfig.yaml file.
  • The LoginPageLink component now supports a new property called idpId. Use it to specify one of the identity providers configured in the siteConfig.yaml file. If you're using React hooks, you can now import the custom hook useLoginPageUrl from @redocly/ui and use it with idpId like in the following example:
const loginLink = useLoginPageUrl(idpId);

Note that these changes apply only to the on-premise Docker container, not to hosted Developer portals.

Deprecated

  • The allowLoginWith configuration option for the on-premise Docker container is now deprecated and should not be used.

1.0.0-beta.108 (2021-02-12)

Fixes

  • Fixed breaking builds after yarn.lock and node_modules are deleted.
  • Fixed the --relative-paths argument by using path prefixes from an environment variable.
  • Fixed incorrect path resolution of reusable Markdown snippets.

1.0.0-beta.107 (2021-02-12)

Broken release.


1.0.0-beta.106 (2021-02-02)

Fixes

  • Pinned mobx dependency to prevent crashes when upgrading.

1.0.0-beta.105 (2021-01-28)

Fixes

  • The search index will no longer crash when page names start with _.
  • Resolved a cryptic JavaScript error when the portal failed to load an OpenAPI definition.
  • Improved real-time reloading when the sidebar state changes to expanded.

1.0.0-beta.104 (2021-01-25)

Fixes

  • Fixed crashing when reusable Markdown snippets are embedded in MDX.
  • Added a warning that snippets are not supported in MDX.
  • Removed bad #undefined hash in some links.

1.0.0-beta.103 (2021-01-25)

Features

  • Redocly now supports single-source authoring and content reuse with Markdown snippets. Create "chunks" of text, save them as Markdown files in your developer portal project, and embed them into other pages across the portal.

Fixes

  • Implemented support for pathPrefix in the RBAC feature.
  • The HTTP scheme name (e.g. Bearer) is now capitalized in code samples.

1.0.0-beta.102 (2021-01-20)

Features

  • Users can now override defaults to customize SearchInput and SearchResults components.

1.0.0-beta.101 (2021-01-15)

Fixes

  • Removed many incorrect warnings that were cluttering the console output.

1.0.0-beta.100 (2021-01-15)

Fixes

  • Resolved an issue with mermaid diagrams overflowing the page size.
  • Resolved a HTML-related nesting issue by rendering ThinTile as a div if it doesn't have the to property.
  • Lint problems are now ignored for registry downloads.

1.0.0-beta.99 (2021-01-14)

Features

  • Developer portal now supports auto-generated C# and Python code samples in embedded API reference documentation.

Fixes

  • Implemented support for the correct default RBAC permission.
  • The mobile view button for expanding the sidebar menu has been temporarily disabled because of a bug in the full non-paginated reference docs page.

1.0.0-beta.98 (2021-01-04)

Features

  • A new front matter configuration option is available - excludeFromSearch. When you add excludeFromSearch: true to the front matter of a Markdown page, the page will be excluded from the search index and will not be accessible from the search results.
  • Implemented support for matchPath in MDX pages. This functionality is required for advanced client routes and for the upcoming Apigee portal integration.

Fixes

  • Hash fragments (named anchors) can now be used in relative links to MD and MDX pages; for example [link](./file.md#section-id).
  • Previously, OAS 2 API definitions could be imported only as files from the local filesystem. Now they can be imported from URLs, and they work with registry snapshot URLs (including the Logs > Snapshots > Get Snapshot option).
  • Resolved a minor styling issue with the position of anchor link icons when targeting an HTML heading.

1.0.0-beta.97 (2020-12-30)

Broken release.


1.0.0-beta.96 (2020-12-17)

Features

  • It is now possible to customize the entire sidebar menu. Check the developer portal starter repository for an example of how to change the sidebar style.
  • By popular demand, links in the navigation bar can now have custom icons. To add a custom icon for an item, provide the path to the icon image as the value of the new icon field in the nav section of the siteConfig.yaml file. An example is available in the developer portal starter repository.

Fixes

  • Improved the look of parameters with multiple examples in Reference docs.

1.0.0-beta.95 (2020-12-15)

Fixes

  • Implemented support for using API reference docs as the index page of the developer portal. This can be achieved either by renaming the reference docs page to index.page.yaml or by setting path: "/" in the corresponding .page.yaml file.
  • Button components without a to link will now be rendered as <button> instead of as <a>.
  • Portal will no longer crash when the siteConfig.yaml file contains an invalid page item in nav.

1.0.0-beta.94 (2020-12-03)

Features

  • Sidebar items can now be customized independently of the developer portal theme. Check the developer portal starter repository for an example of how to style the sidebar items.

1.0.0-beta.93 (2020-11-26)

Features

  • A new CLI option --ignore-openapi-errors is now supported. When this option is used, the portal build will not fail if validation errors are found in API definition files.
  • Implemented a new helper React hook called useAPICatalog in @redocly/ui. It returns a list of all API definitions in the developer portal project (plus some metadata), and can be used to create API catalog pages. ​

1.0.0-beta.92 (2020-11-23)

  • Internal release without changes.

1.0.0-beta.91 (2020-11-22)

Features

  • Implemented support for the RBAC (Role-based access control) feature. With RBAC, you can define permissions for accessing specific parts of your developer portal, and assign those permissions to different types of users (roles). This feature is available only to Enterprise customers, and only if the developer portal is hosted on-premise using Docker.

Fixes

  • Fixed the style for code blocks inside headings.

1.0.0-beta.90 (2020-11-18)

Features

  • The siteConfig.yaml file now supports linking to external API definition files by using $ref in the oasDefinitions section.

1.0.0-beta.89 (2020-11-13)

Fixes

  • Resolved an issue with alert content rendering when content was passed as React children.
  • Minor TypeScript type fixes been implemented.

1.0.0-beta.88 (2020-11-06)

Features

  • The Alert UI component now supports nested content for all alert variants. Nested content is added to an alert using the children property.

Fixes

  • Properly applied the fix for broken code highlighting on initial page load (issue carried over from previous release).
  • All page links on the portal now use lowercase letters. Page links that previously contained uppercase letters will be automatically transformed to all lowercase letters (for example, ./developer-portal/Getting-Started.md becomes /developer-portal/getting-started/). As a consequence, some links may break after updating to this version of the Developer portal.
  • When adding pages to the portal using the /* "spread" pattern to include all files from a path, the pages will now be grouped by folder in the navigation sidebar.

1.0.0-beta.87 (2020-11-02)

Fixes

  • Resolved an issue with broken code highlighting on initial page load.
  • Implemented a performance fix in search-indexer for API definitions that use deep-nested oneOf. This change potentially resolves the RAM overflow issue reported by some customers.
  • Fixed the 401 error for manifest.json file when using basic authentication.

1.0.0-beta.86 (2020-10-29)

Features

  • Code samples in Reference docs can now be automatically generated for curl, JavaScript, and Node.js. This feature can be enabled for on-premise Developer portal deployments by editing the .page.yaml configuration file.

Fixes

  • Reduced the clutter in the browser log output.

1.0.0-beta.85 (2020-10-28)

Features

  • Upgraded to the latest version of reference-docs. This version introduces support for CORS Proxy configuration, allowing more control over requests sent from the "Try It" API console.

1.0.0-beta.84 (2020-10-21)

Features

  • New options for styling the portal sidebar are now available; namely: sidebar.textColor, sidebar.activeTextColor, and sidebar.activeBgColor.

Fixes

  • The layout of API reference docs is no longer broken on small screen sizes in Firefox. GitHub issue reference
  • Styled components can now be used for styling ThinTile, WideTile and Alert.
  • Custom queries will be properly extracted from MDX files with Windows-style line endings.
  • colors.<color>.contrastText can now be used for the Alert text color, where <color> is warning, success, error, or info.

1.0.0-beta.83 (2020-10-20)

Features

  • Allow running development server on GitHub Codespaces.
  • Upgrade reference-docs to v1.1.5.
  • Copy auth metadata to artifacts folder (for on-prem auth-server).

Fixes

  • Reduced clutter in the log output.

1.0.0-beta.82 (2020-09-28)

Fixes

  • Resolved an issue with redirecting to the developer portal home page after the user logs out.
  • Exported the setSecurityDetails helper.

1.0.0-beta.81 (2020-09-15)

Fixes

  • Fix requireLogin infinite reloading.

1.0.0-beta.80 (2020-09-15)

Fixes

  • Fix some utility functions that were not exported.

1.0.0-beta.79 (2020-09-15)

Features

  • Export helpers for anonymous login.

Fixes

  • Fix JsonSchema style issue.

1.0.0-beta.78 (2020-09-11)

Features

  • Add new side menu style: drilldown.

1.0.0-beta.77 (2020-09-11)

Features

  • Add new OpenAPI-powered components: OpenApiRequestBody, OpenApiExample, JsonSchema.

Bug fixes

  • Fix non-expanded reference docs broken build.

Deprecations

  • Renamed APIResponse to OpenApiResponse.

1.0.0-beta.76 (2020-09-03)

Features

  • Use remote rendering for mermaid diagrams.
  • Support for IdP issued tokens for Redocly Workflows OIDC integration.

1.0.0-beta.75 (2020-09-03)

Broken release.


1.0.0-beta.74 (2020-08-26)

Bug fixes

  • Fixed badge label for webhooks (with x-webhooks usage).

1.0.0-beta.73 (2020-08-25)

Features

  • Upgrade to the latest Redocly reference-docs:

    • x-webhooks support
    • accessibility features

Bug fixes

  • Fixed broken pages with spread /*.

1.0.0-beta.72 (2020-08-17)

Bug fixes

  • Proper error message for missing pages with spread /* instead of crash.

Features

  • Export some auth helpers: useProxiedFetch, getUserJwt, getUserId.

1.0.0-beta.71 (2020-07-28)

Bug fixes

  • Fixed WideTile icon margins.

1.0.0-beta.70 (2020-07-28)

Bug fixes

  • Adjusted default style of Tiles.

1.0.0-beta.69 (2020-07-28)

Features

  • Add new style properties to ThinTile and WideTile.
  • Add colors.navbar.gradient toggle to the theme.ts.
  • Support code snippet title

    Example usage

    Syntax:

    ```js JavaScript Example
    console.log('Hello, JS');
    ```
    
    ```python Python Example
    print('Hello, python');
    ```

    Result:

    JavaScript ExamplePython Example
    console.log('Hello, JS');
    print('Hello, python');
  • Upgrade mermaid to ^8.6.0 (support auto-wrapping and newlines).
  • Add option tocMaxDepth to limit the number of nested levels (globally in siteConfig.yaml or in front matter).
  • Add option disableLastModified to hide last modified label (globally in siteConfig.yaml or in front matter).

Bug fixes

  • Fix local css loading on Windows.
  • Fix inconsistent box shadow for thin tile.
  • Fix site meta image.
  • Support relative paths starting with ./ in sidebar.yaml.
  • Support external: true to show external site icon for sidebar menu items.
  • Fix "Next to" button for groups with page.