Skip to content

A template for creating a new Remix Auth strategy.

License

Notifications You must be signed in to change notification settings

sergiodxa/remix-auth-strategy-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Remix Auth - Strategy Template

A template for creating a new Remix Auth strategy.

If you want to create a new strategy for Remix Auth, you could use this as a template for your repository.

The repo installs the latest version of Remix Auth and do the setup for you to have tests, linting and typechecking.

How to use it

  1. In the package.json change name to your strategy name, also add a description and ideally an author, repository and homepage keys.
  2. In src/index.ts change the MyStrategy for the strategy name you want to use.
  3. Implement the strategy flow inside the authenticate method. Use this.success and this.failure to correctly send finish the flow.
  4. In tests/index.test.ts change the tests to use your strategy and test it. Inside the tests you have access to jest-fetch-mock to mock any fetch you may need to do.
  5. Once you are ready, set the secrets on Github
    • NPM_TOKEN: The token for the npm registry
    • GIT_USER_NAME: The git username you want the bump workflow to use in the commit.
    • GIT_USER_EMAIL: The email you want the bump workflow to use in the commit.

Scripts

  • build: Build the project for production using the TypeScript compiler (strips the types).
  • typecheck: Check the project for type errors, this also happens in build but it's useful to do in development.
  • lint: Runs ESLint against the source codebase to ensure it pass the linting rules.
  • test: Runs all the test using Jest.

Documentations

To facilitate creating a documentation for your strategy, you can use the following Markdown

# Strategy Name

<!-- Description -->

## Supported runtimes

| Runtime    | Has Support |
| ---------- | ----------- |
| Node.js    ||
| Cloudflare ||

<!-- If it doesn't support one runtime, explain here why -->

## How to use

<!-- Explain how to use the strategy, here you should tell what options it expects from the developer when instantiating the strategy -->

About

A template for creating a new Remix Auth strategy.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •