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
- Go to guardhouse.cloud
- Click Sign Up
- Enter your email and create a password
- Create your organization name (e.g., "My Awesome Company")
You now have a Guardhouse organization! 🎉
Step 2: Register Your Application
- Go to the Admin Panel
- Click Applications in the sidebar
- Click New Application
- Enter your app name:
My First App - Select application type: Web Application (or Mobile, SPA, etc.)
- 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
- Start your app
- Click the Login button
- You'll be redirected to Guardhouse login
- Log in with your Guardhouse account
- 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.