This repo demonstrates how to integrate Hanko with React application for authentication and user management. It includes an Express.js backend for JWT verification and middleware for securing pages under authentication.
Hanko is an open-source authentication and user management solution with a focus on moving the login beyond passwords while being 100% deployable today.
- Built for passkeys as introduced by Apple, Google, and Microsoft
- Fast integration with Hanko Elements web components (login box and user profile)
- API-first, small footprint, cloud-native
Before you begin, ensure you have the following:
- Node.js installed (version 20.0.0 or later)
- Hanko API URL from Hanko Cloud
Note: You'll need to create a Authentication Project on Hanko Cloud with the App URL
http://localhost:5173. See our docs to learn how to setup a auth project.
- Clone the repository
git clone https://github.com/teamhanko/hanko-react-express-starter.git- Navigate to the frontend directory:
cd hanko-react-frontend- Create a
.envfile in the frontend directory (hanko-react-frontend) and add the following environment variable:
VITE_HANKO_API_URL=your-hanko-api-url- Install the frontend dependencies using your preferred package manager (e.g.,
npm,pnpm,yarn, orbun). For this project, we've usedpnpm:
pnpm install- Start the frontend development server:
pnpm dev- Navigate to the backend directory:
cd express-server- Create a
.envfile in the backend directory (express-server) and add the following environment variable:
HANKO_API_URL=your-hanko-api-url- Install the backend dependencies:
pnpm install- Start the backend server:
pnpm dev-
Start the application:
- Access the application by navigating to
http://localhost:5173in your web browser.
- Access the application by navigating to
-
Navigate to login page and experience Hanko Authentication.
Feel free to reach out to us on Discord if you get into any issues.
This project is licensed under the MIT License.