# Clerk Changelog — Page 37 # Changelog January 27, 2023 URL: https://clerk.com/changelog/2023-01-27.md Date: 2023-01-27 Category: Company Description: Refactored API keys, Gatsby V5, Dynamic documentation, and migration support for Redwood self-hosted Auth. ## Refactored API keys We've refactored our API keys to a more familiar format: - Publishable key (prefixed with `pk_test_` or `pk_live_`) - Secret key (prefixed with `sk_test_` or `sk_live_`) #### Quick copy With this upgrade, we introduced a quick copy in our dashboard for each of our SDKs allowing you to move faster than ever. ![Quick copy screenshot](./f3f16975a1d14b6c2c8f320332ec0e7601dba880-1474x460.png) ### What about legacy keys? Legacy keys are still available in the dashboard and can continue to be used. Once ready to [upgrade](/docs/upgrade-guides/api-keys), you will need to replace all the keys simultaneously, as you cannot mix the legacy keys with the new ones. ### But why? Learn more about the [motivation behind our new keys](/blog/refactoring-our-api-keys). ## Documentation improvements Developer experience is huge for us here at Clerk, and with that, we want to make it easy to get started and easier to find what you are looking for. ### Dynamic documentation Last week we introduced new environment-driven examples, allowing us to insert your keys into our docs. This is only in our get-started sections, but we want to add it to more places in the near future. ### Search improvements We spent some time improving the search and results that were returned, this has been high on our list this month, and we think the improvement already shows. ## t3-turbo-and-clerk We launched a new starter repo called [t3-turbo-and-clerk](https://github.com/clerkinc/t3-turbo-and-clerk). For the launch, we collaborated with t3's creator, Theo Browne, to show off the simplicity of the solution. Check it out: ## Gatsby V5 We updated our Gatsby plugin to support Gatsby V5. You can now access the user's authentication state on the client or the server. Below are examples of SSR and API routes: #### SSR ```tsx {{ title: '/pages/ssr.tsx' }} import * as React from 'react' import { GetServerData } from 'gatsby' import { withServerAuth } from 'gatsby-plugin-clerk/ssr' export const getServerData: GetServerData = withServerAuth( async (props) => { return { props: { data: '1', auth: props.auth } } }, { loadUser: true }, ) function SSRPage({ serverData }: any) { return (

SSR Page with Clerk

{JSON.stringify(serverData, null, 2)}
) } export default SSRPage ``` #### API Routes ```typescript {{ title: '/api/hello.ts' }} import { clerkClient, withAuth } from 'gatsby-plugin-clerk/api' interface ContactBody { message: string } const handler = withAuth(async (req, res) => { const users = await clerkClient.users.getUserList() res.send({ title: `We have ${users.length} users`, message: req.body.message, auth: req.auth, }) }) export default handler ``` ## Redwood dbAuth migration Support We now support migrating users and their hashed passwords (using pbkdf2\_sha1) from RedwoodJS dbAuth to Clerk using our [API](/docs/reference/backend-api/tag/users/POST/users). Migrating for another tool? Contact support to let us know if you need us to add another hashing algorithm. ## Node 12 is no longer supported We have dropped support for Node 12 and will be only supporting Node 14 or higher. ## Community Highlights ### Brazilian translation A massive shoutout to Darlan for his first contribution to Clerk by adding a [Brazilian translation](https://github.com/clerkinc/javascript/pull/728) to our Clerk components. --- # Changelog January 20, 2023 URL: https://clerk.com/changelog/2023-01-20.md Date: 2023-01-20 Category: Company Description: Clerk has gone isomorphic, updated organization details page, and two deprecated packages ## Clerk has gone isomorphic We refactored our SDKs to allow for isomorphism. This means we can offer more V8 runtimes, such as Cloudflare workers. You can see the new backend package we are using under the hood in our [GitHub Repository](https://github.com/clerkinc/javascript/tree/main/packages/backend) ## Deprecated Packages With the changes described above have deprecated two packages as they are no longer needed to run server-side requests: ```bash @clerk/backend-core @clerk/edge ``` ## Organization details update The organization details page in the dashboard has been updated to be easier to manage your organization. You can now: - Change the organization name - Update membership limits - Add or update public or private metadata - Delete unused organization ![Organization details update screenshot](./d2692f066854954738b9ed5bd2cafe5d70001a9a-1310x1130.png) ## How to stay up to date with Clerk? The best way to keep up with Clerk is to subscribe to our newsletter. We send out updates every week. Updates include new features, what we have been working on, and blog posts you may have missed! ### Clerk Community Discord Clerk has a community [Discord](https://clerk.com/discord). When you join, you will find a place: - Find the latest Clerk news and announcements - Share your project with the Clerk community, and talk about your experience - Request features and gets help integrating Clerk from the team and community. ### Clerk Twitter Our X account ([@clerk](https://x.com/clerk)) announces the latest features and improvements. We would also be psyched if you tagged us in projects you have built. --- # Changelog December 23, 2022 URL: https://clerk.com/changelog/2022-12-23.md Date: 2022-12-23 Category: Company Description: New backend API reference documentation, useAuth improvements and Italian language support ## New Backend API reference docs We created new backend API reference documentation that is automatically updated when we release any changes to Production based on the OpenAPI specification. This upgrade shows successful and unsuccessful payloads and what to expect from a type. It can also run a test request in the browser, allowing you to see a request and response using your API key. Check it out at [the Backend API reference](/docs/reference/backend-api) Thanks to the contributors: Mark Pitsilos, James Perkins ## `useAuth` improvements The `useAuth` hook now contains `orgId`, `orgSlug`, `orgRole` allowing you to access organization data when you need it on the client. ## Italian Language Support A massive shoutout to nitroin for opening up a pull request into our `@clerk/localization` package to add Italian translations to all our components. ```jsx import { itIT } from '@clerk/localizations' const App = () => { return {/* ... */} } ``` ![Italian Language Support screenshot](./188c4da2b0e8ffcc64aba2f78b88036d54197815-1102x1244.png) ## Bug fixes and Performance improvements We fixed a few bugs this week that are important to highlight. #### Apple OAuth User name We now return the user name from a sign in when using Apple as the OAuth provider. #### Respect JWKS cache We fixed a bug in our Ruby SDK, which now respects the JWKS cache specified. #### Performance improvements to users endpoint We have improved the performance of the `/api/users/` endpoint, you should already notice the difference! ## How to stay up to date with Clerk? The best way to keep up with Clerk is to subscribe to our newsletter. We send out updates every week. Updates include new features, what we have been working on, and blog posts you may have missed! ### Clerk Community Discord Clerk has a community [Discord](https://clerk.com/discord). When you join, you will find a place: - Find the latest Clerk news and announcements - Share your project with the Clerk community, and talk about your experience - Request features and gets help integrating Clerk from the team and community. ### Clerk Twitter Our X account ([@clerk](https://x.com/clerk)) announces the latest features and improvements. We would also be psyched if you tagged us in projects you have built. --- # Changelog December 16, 2022 URL: https://clerk.com/changelog/2022-12-16.md Date: 2022-12-16 Category: Company Description: No more third-party cookies, pricing updates, and an educational youtube channel. ## URL-based session syncing We have been working on making development no longer require any third-party cookies. This is now out of experimental, and all instances created from now on won't' use them. Development instances created before December 6, 2022, still communicate to the Clerk frontend API using cookies. You can follow our [upgrade guide ](/docs/upgrade-guides/url-based-session-syncing#migrating-to-url-based-session-syncing)to migrate to URL-based session syncing. Thanks to the contributors: Haris Chaniotakis, Agis Anastasopoulos, Nikos Douvlis ## Pricing Changes We updated our pricing and our free plan to serve our users better. You can now have up to 5,000 monthly active users and ten organizations for free with no credit card required. Our hobby and business plan prices have been reduced to $25 and $99, respectively. We updated our [pricing page](/pricing) to make it even easier to figure out what it will cost to run your SaaS. Thanks to the contributors: Marcel Cruz, Charles Wefso ## Launching A YouTube Channel Clerk is invested in educating people on the modern web alongside authentication and user management. We have launched a dedicated YouTube to cover topics on the modern web and how to use Clerk in complex applications. Check out the video below on using TRPC and Clerk to create a secure typesafe application. If you are interested in the modern web and Clerk make sure you subscribe. ## How to stay up to date with Clerk? The best way to keep up with Clerk is to subscribe to our newsletter. We send out updates every week. Updates include new features, what we have been working on, and blog posts you may have missed! ### Clerk Community Discord Clerk has a community [Discord](https://clerk.com/discord). When you join, you will find a place: - Find the latest Clerk news and announcements - Share your project with the Clerk community, and talk about your experience - Request features and gets help integrating Clerk from the team and community. ### Clerk Twitter Our X account ([@clerk](https://x.com/clerk)) announces the latest features and improvements. We would also be psyched if you tagged us in projects you have built. --- # Changelog December 9, 2022 URL: https://clerk.com/changelog/2022-12-09.md Date: 2022-12-09 Category: Company Description: 6.2 million dollars in funding, Support for Cloudflare workers, Localization improvements, Invite your team to Clerk and new social logins ## $6.2m new funding, led by a16z On November 30th, we announced $6.2m in new funding led by Martin Casado at Andreessen Horowitz, with continued participation from S28 Capital, Fathom Capital, and South Park Commons. This funding marks a significant milestone for Clerk. For the first time, we've raised based on the traction of our customers, who are simply blowing us away with their continued success. You can read the [full blog post](/blog/a16z-seed) from our CEO Colin. ## Support for Cloudflare workers With the latest release of `@clerk/remix `we can now support Cloudflare workers, Cloudflare pages, Node, and Deno. This was a long-requested feature, and we are glad we can start supporting the runtime of your choice. To learn how to use experimental support, check out the [documentation](/docs/quickstarts/get-started-with-remix#using-experimental-edge-runtimes). ## Localization improvements ### `@clerk/localizations` We introduced a new open-source package this week called `@clerk/localizations` that allows you to import a language and use it in our components. If you have translated your Clerk components into another language, feel free to [open a PR](https://github.com/clerkinc/javascript/tree/main/packages/localizations) and hope the Clerk community. ```jsx import { ClerkProvider } from '@clerk/nextjs' import { frFR } from '@clerk/localizations' function MyApp({ Component, pageProps }) { return ( ) } export default MyApp ``` ![Next.js integration example](./1e85fbb3aa4cdf9c6f36d4b34b5a5f5000bfc077-816x458.png) ## Datetime localization As part of our localization effort, we also introduced Datetime localization, allowing you to present your user with the correct format based on their location. For example: ```jsx {{ prettier: false }} dates: { previous6Days: "{{ date | weekday('fr-FR','long') | titleize }} dernier à {{ date | timeString('fr-FR') }}", }, ``` Thanks to the contributors: Nikos Douvlis, Stefanos Anagnostou ## Invite your team The Clerk dashboard now supports organizations in the Dashboard, allowing you to invite team members who need access to the admin panel with a single click. We also give you a personal workspace for all those side projects you've been thinking of. If you already have an application in your Dashboard that isn't attached to an organization but needs to be transferred, with a few clicks, you can transfer the ownership. ## Sign in with Xero and Box. We now support Box and Xero for social logins bringing our total to 20 supported providers! Check out our integration documentation if you are interested in [Box](/docs/authentication/social-connection-with-box) or [Xero](/docs/authentication/social-connection-with-xero). ## Community shoutout A massive shoutout to our Discord member [David](https://github.com/dvargas92495) who created a [Terraform module](https://registry.terraform.io/modules/dvargas92495/clerk/aws/latest) that allows hook up your Clerk instance to AWS. ## How to keep up to date with Clerk? The best way to keep up with Clerk is to subscribe to our newsletter. We send out updates every week. Updates include new features, what we have been working on, and blog posts you may have missed! ### Clerk Community Discord Clerk has a community [Discord](https://clerk.com/discord). When you join, you will find a place: - Find the latest Clerk news and announcements - Share your project with the Clerk community, and talk about your experience - Request features and gets help integrating Clerk from the team and community. ### Clerk Twitter Our X account ([@clerk](https://x.com/clerk)) announces the latest features and improvements. We would also be psyched if you tagged us in projects you have built. --- # Changelog November 18, 2022 URL: https://clerk.com/changelog/2022-11-18.md Date: 2022-11-18 Category: Company Description: Next.js app updates, improvements in appearance, and localization in Org components. TRPC support This week Clerk has been focusing on improvements to our documentation, bug fixes, and iterating on our Organization components. ## Organization Components improvements Our organization components were released just last week, and we received a lot of great feedback from our users. We fixed some bugs and made improvements to the `appearance` and `localization` props. ## Next.js app directory beta updates Clerk has been working hard on our app directory beta. One of the most significant changes this week is it is now rolled into the latest production package. We also updated our documentation to reflect this, which you can read [here](/docs/nextjs/v13-beta). ## TRPC + Clerk We introduced documentation for alternative backends, starting with TRPC. I am a massive fan of TRPC and its end-to-end type safety. If you are thinking about checking out Clerk and love TRPC, we now have [documentation](/docs/nextjs/trpc) on how to integrate them. If you want to see everything in action, check out the [clerk-trpc-minimal repository](https://github.com/perkinsjr/clerk-trpc-minimal). ## Community highlight A special thanks to Molo Tech Lab for their amazing project [JSON translator](https://github.com/mololab/json-translator) that allowed the team to translate our components into French and German. This project is open source, free, and under the MIT license. Thanks to our customer Finary for showing us this cool project.