https://github.com/authgear/auth-toolkit
In-browser JWT/JWE, JWK/JWKS, HMAC, SAML, and TOTP tools for developers. Perfect for authentication development and testing.
https://github.com/authgear/auth-toolkit
Last synced: 10 months ago
JSON representation
In-browser JWT/JWE, JWK/JWKS, HMAC, SAML, and TOTP tools for developers. Perfect for authentication development and testing.
- Host: GitHub
- URL: https://github.com/authgear/auth-toolkit
- Owner: authgear
- Created: 2025-08-29T16:13:02.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-29T18:09:55.000Z (10 months ago)
- Last Synced: 2025-08-29T19:54:55.081Z (10 months ago)
- Language: TypeScript
- Homepage: https://authgear.github.io/auth-toolkit/
- Size: 717 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Auth Toolkit Landing Page
Auth Developer Mini-Toolkit
In-browser JWT/JWE, JWK/JWKS, HMAC, SAML, and TOTP tools for developers. Perfect for authentication development and testing.
## Local Development
### Prerequisites
- Node.js 18+
- pnpm (recommended) or npm
### Setup
1. **Install dependencies**
```bash
pnpm install
```
2. **Start development server**
```bash
pnpm dev
```
3. **Open your browser**
Navigate to [http://localhost:3000](http://localhost:3000)
### Build Commands
- **Development**: `pnpm dev`
- **Build**: `pnpm build`
- **Start Production**: `pnpm start`
- **Lint**: `pnpm lint`
## Project Structure
```
auth-toolkit/
├── app/ # Next.js app directory
│ ├── globals.css # Global styles
│ ├── layout.tsx # Root layout
│ └── page.tsx # Home page
├── components/ # Reusable UI components
│ └── ui/ # Base UI components
├── data/ # Static data files
├── lib/ # Utility functions
└── public/ # Static assets
```
## Google Tag Manager Setup
To enable Google Tag Manager tracking:
1. **Create environment file**
```bash
cp env.example .env.local
```
2. **Set your GTM ID**
Edit `.env.local` and replace `GTM-XXXXXXX` with your actual GTM ID:
```bash
NEXT_PUBLIC_GTM_ID=GTM-ABC123XY
```
3. **Deploy with environment variable**
- For local development: GTM will work automatically
- For production: Set the environment variable in your deployment platform
- For GitHub Pages: Add the environment variable to GitHub Actions secrets
**Note**: The `.env.local` file is gitignored and won't be committed to the repository.
## Deployment
### GitHub Pages
This project is configured for static export and GitHub Pages deployment:
1. **Build the project**
```bash
pnpm build
```
2. **Deploy to GitHub Pages**
- Push to your repository
- Enable GitHub Pages in repository settings
- Set source to "GitHub Actions" or "Deploy from a branch"
- The `out/` directory contains the static files
## Adding New Tools
Edit `data/tools.json` to add new authentication tools:
```json
{
"title": "Tool Name",
"description": "Tool description",
"url": "https://tool-url.com",
"icon": "IconName"
}
```