Skip to main content

Quick Start (5 Minutes)

Get your first Guardhouse application running in 5 minutes.

Prerequisites

  • A Guardhouse account (sign up at guardhouse.cloud)
  • A simple web application or just Node.js installed

Step 1: Create an Organization

  1. Go to guardhouse.cloud
  2. Click Sign Up
  3. Enter your email and create a password
  4. Create your organization name (e.g., "My Awesome Company")

You now have a Guardhouse organization! 🎉

Step 2: Register Your Application

  1. Go to the Admin Panel
  2. Click Applications in the sidebar
  3. Click New Application
  4. Enter your app name: My First App
  5. Select application type: Web Application (or Mobile, SPA, etc.)
  6. Click Create

You'll see:

  • Client ID - Copy this
  • Client Secret - Copy this (keep it secret!)
  • Redirect URI - Add your app's callback URL

For development, use: http://localhost:3000/callback

Step 3: Use Our SDK

Node.js Example

Install the SDK:

npm install @guardhouse/sdk

app.listen(3000);

text

React Example

Install the SDK:

npm install @guardhouse/react

Step 4: Test It

  1. Start your app
  2. Click the Login button
  3. You'll be redirected to Guardhouse login
  4. Log in with your Guardhouse account
  5. You'll be redirected back with a token

Done! ✅

Next Steps

Troubleshooting

Getting a redirect error? Make sure your Redirect URI in the Admin Panel matches exactly (including http:// vs https://).

Token verification failed? Check that your Client Secret is correct and keep it safe.