4.4.36 • Published 2 months ago

gatsby-plugin-clerk v4.4.36

Weekly downloads
-
License
MIT
Repository
github
Last release
2 months ago

gatsby-plugin-clerk

Chat on Discord Clerk documentation Follow on Twitter

Changelog · Report a Bug · Request a Feature · Ask a Question


Overview

Clerk is the easiest way to add authentication and user management to your Gatsby application. Add sign up, sign in, and profile management to your application in minutes.

Getting Started

Prerequisites

  • Gatsby v5+
  • Node.js v18+

Installation

npm install gatsby-plugin-clerk

Usage

Make sure the following environment variables are set in a .env file:

GATSBY_CLERK_PUBLISHABLE_KEY=your_publishable_key
CLERK_SECRET_KEY=your_secret_key

You can get these from the API Keys screen in your Clerk dashboard.

To initialize Clerk with your Gatsby application, simply register the plugin in your gatsby-config.ts/gatsby-config.js file. Also, use dotenv to access environment variables.

// gatsby-config.ts
import type { GatsbyConfig } from 'gatsby';

require('dotenv').config({
  path: `.env.${process.env.NODE_ENV}`,
});

const config: GatsbyConfig = {
  // ...the rest of your config object
  plugins: ['gatsby-plugin-clerk'],
};

export default config;

Client-side

After those changes are made, you can use Clerk components in your pages.

For example, in src/pages/index.tsx:

import { SignedIn, SignedOut, SignInButton, UserButton } from 'gatsby-plugin-clerk';

const IndexPage = () => {
  return (
    <div>
      <h1>Hello Clerk!</h1>
      <SignedIn>
        <UserButton />
      </SignedIn>
      <SignedOut>
        <SignInButton mode='modal' />
      </SignedOut>
    </div>
  );
};

export default IndexPage;

Server-Side Rendering (SSR)

Using withServerAuth from 'gatsby-plugin-clerk/ssr'. Example file /pages/ssr.tsx:

import * as React from 'react';
import { GetServerData } from 'gatsby';
import { withServerAuth } from 'gatsby-plugin-clerk/ssr';

export const getServerData: GetServerData<any> = withServerAuth(
  async props => {
    return { props: { data: '1', auth: props.auth } };
  },
  { loadUser: true },
);

function SSRPage({ serverData }: any) {
  return (
    <main>
      <h1>SSR Page with Clerk</h1>
      <pre>{JSON.stringify(serverData, null, 2)}</pre>
    </main>
  );
}

export default SSRPage;

Server API routes

Importing 'gatsby-plugin-clerk/api' gives access to all the exports coming from @clerk/sdk-node. Example file /api/hello.ts:

import { clerkClient, withAuth } from 'gatsby-plugin-clerk/api';

const handler = withAuth(async (req, res) => {
  const users = await clerkClient.users.getUserList();
  res.send({ title: `We have ${users.length} users`, auth: req.auth });
});

export default handler;

For further details and examples, please refer to our Documentation.

Build

To build the package locally with the TypeScript compiler, run:

npm run build

To build the package in watch mode, run the following:

npm run dev

Support

You can get in touch with us in any of the following ways:

Contributing

We're open to all community contributions! If you'd like to contribute in any way, please read our contribution guidelines.

Security

gatsby-plugin-clerk follows good practices of security, but 100% security cannot be assured.

gatsby-plugin-clerk is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

License

This project is licensed under the MIT license.

See LICENSE for more information.

5.0.0-beta.23

3 months ago

5.0.0-beta.22

3 months ago

5.0.0-beta-v5.21

3 months ago

4.4.36

3 months ago

4.4.35

3 months ago

5.0.0-beta-v5.20

4 months ago

4.4.34

4 months ago

5.0.0-alpha-v5.19

4 months ago

5.0.0-alpha-v5.18

4 months ago

4.4.33

4 months ago

5.0.0-alpha-v5.17

4 months ago

5.0.0-alpha-v5.15

4 months ago

4.4.32

4 months ago

5.0.0-alpha-v5.14

4 months ago

5.0.0-alpha-v5.13

5 months ago

4.4.31

5 months ago

4.4.30

5 months ago

5.0.0-alpha-v5.12

5 months ago

5.0.0-alpha-v5.11

5 months ago

4.4.29

5 months ago

4.4.28

5 months ago

5.0.0-alpha-v5.9

5 months ago

4.4.27

5 months ago

5.0.0-alpha-v5.8

5 months ago

4.4.21

6 months ago

4.4.20

7 months ago

4.4.25

5 months ago

4.4.24

6 months ago

4.4.23

6 months ago

4.4.22

6 months ago

4.4.26

5 months ago

4.4.18

7 months ago

4.4.17

7 months ago

4.4.16

7 months ago

4.4.19

7 months ago

5.0.0-alpha-v5.3

6 months ago

5.0.0-alpha-v5.2

6 months ago

5.0.0-alpha-v5.1

6 months ago

5.0.0-alpha-v5.0

6 months ago

5.0.0-alpha-v5.7

5 months ago

5.0.0-alpha-v5.6

5 months ago

5.0.0-alpha-v5.5

5 months ago

5.0.0-alpha-v5.4

6 months ago

4.4.9

8 months ago

4.4.8

8 months ago

4.4.7

8 months ago

4.4.6

8 months ago

4.4.10

7 months ago

4.4.14

7 months ago

4.4.13

7 months ago

4.4.12

7 months ago

4.4.11

7 months ago

4.4.15

7 months ago

4.4.5

8 months ago

4.3.7-snap.a0dd011

11 months ago

4.3.7-snap.3210eda

11 months ago

4.3.1-staging.0

12 months ago

4.3.1-staging.1

12 months ago

4.3.7-snap.8fda67e

11 months ago

4.3.6-staging.3

11 months ago

4.3.6-staging.4

11 months ago

4.3.6-staging.1

11 months ago

4.3.6-staging.2

11 months ago

4.3.6-staging.0

11 months ago

4.3.7-snap.219d1fb

11 months ago

4.2.8-staging.4

12 months ago

4.3.7-snap.e2ec9c0

11 months ago

4.3.7-snap.77525ba

11 months ago

4.3.7-snap.46c588e

11 months ago

4.3.7-snap.f75792d

11 months ago

4.4.1

10 months ago

4.4.0

10 months ago

4.4.3

10 months ago

4.4.2

10 months ago

4.3.7-snap.691991c

11 months ago

4.4.4

9 months ago

4.3.7-snap.5fede9e

11 months ago

4.3.2

12 months ago

4.3.7-snap.cd256f5

11 months ago

4.3.1

12 months ago

4.3.4

12 months ago

4.3.3

12 months ago

4.3.0

12 months ago

4.3.9

11 months ago

4.3.6

11 months ago

4.3.5

12 months ago

4.3.8

11 months ago

4.3.7

11 months ago

4.3.13

11 months ago

4.3.12

11 months ago

4.3.11

11 months ago

4.3.10

11 months ago

4.3.17

11 months ago

4.3.16

11 months ago

4.3.15

11 months ago

4.3.14

11 months ago

4.3.19

10 months ago

4.3.7-snap.9208293

11 months ago

4.3.18

11 months ago

4.3.5-staging.0

12 months ago

4.2.8

12 months ago

4.3.7-snap.5909c28

11 months ago

4.3.2-staging.0

12 months ago

4.3.2-staging.1

12 months ago

4.3.7-snap.2150b23

11 months ago

4.3.3-staging.2

12 months ago

4.3.20

10 months ago

4.3.7-snap.af9b738

11 months ago

4.3.3-staging.0

12 months ago

4.3.3-staging.1

12 months ago

4.2.4-staging.0

1 year ago

4.2.6-staging.0

1 year ago

4.2.7-staging.3

1 year ago

4.2.7-staging.4

1 year ago

4.2.7-staging.5

1 year ago

4.2.7-staging.0

1 year ago

4.2.7-staging.1

1 year ago

4.2.7-staging.2

1 year ago

4.2.8-staging.0

1 year ago

4.2.8-staging.1

1 year ago

4.2.8-staging.2

12 months ago

4.2.8-staging.3

12 months ago

4.2.5-staging.0

1 year ago

4.2.3

1 year ago

4.2.5

1 year ago

4.2.4

1 year ago

4.2.7

1 year ago

4.2.6

1 year ago

4.2.3-staging.3

1 year ago

4.2.3-staging.2

1 year ago

4.2.1-staging.0

1 year ago

4.2.1-staging.2

1 year ago

4.1.8

1 year ago

4.2.1-staging.1

1 year ago

4.1.7

1 year ago

4.2.1-staging.4

1 year ago

4.2.1-staging.3

1 year ago

4.1.9

1 year ago

4.1.8-staging.1

1 year ago

4.1.8-staging.0

1 year ago

4.1.4-staging.1

1 year ago

4.1.4-staging.0

1 year ago

4.1.5-staging.3

1 year ago

4.1.5-staging.2

1 year ago

4.1.5-staging.5

1 year ago

4.1.5-staging.7

1 year ago

4.1.5-staging.6

1 year ago

4.2.2

1 year ago

4.2.1

1 year ago

4.2.0

1 year ago

4.1.5-staging.1

1 year ago

4.1.5-staging.0

1 year ago

4.1.9-staging.0

1 year ago

4.1.9-staging.1

1 year ago

4.2.2-staging.0

1 year ago

4.1.10

1 year ago

4.1.11

1 year ago

4.1.16

1 year ago

4.1.17

1 year ago

4.1.18

1 year ago

4.1.13

1 year ago

4.1.14

1 year ago

4.1.15

1 year ago

4.2.0-staging.1

1 year ago

4.2.0-staging.0

1 year ago

4.1.4

1 year ago

4.1.3

1 year ago

4.1.6

1 year ago

4.1.5

1 year ago

4.1.3-staging.2

1 year ago

4.1.3-staging.0

1 year ago

4.1.7-staging.0

1 year ago

4.1.3-staging.1

1 year ago

4.2.3-staging.1

1 year ago

4.2.3-staging.0

1 year ago

4.0.1-staging.4

1 year ago

4.0.1-staging.3

1 year ago

4.0.1-staging.2

1 year ago

4.0.1-staging.1

1 year ago

4.1.1-staging.0

1 year ago

4.0.1-staging.0

1 year ago

4.1.2-staging.1

1 year ago

4.1.2-staging.0

1 year ago

4.0.0-staging.2

1 year ago

4.0.0-staging.1

1 year ago

4.0.2-staging.0

1 year ago

4.0.2-staging.1

1 year ago

4.0.1

1 year ago

4.0.0

1 year ago

4.1.2

1 year ago

4.1.1

1 year ago

4.0.2

1 year ago

3.0.0-alpha.1

2 years ago

3.0.0-alpha.2

2 years ago

2.0.0

3 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago