First-Time Setup

After installing Range Warden, follow this guide to configure the system before your staff and members start using it. This entire process is performed by an administrator.

1. Log in with the default admin account

Open your browser and navigate to your Range Warden instance (e.g., http://localhost:3000).

Log in with the default credentials:

• Email: [email protected]
• Password: admin

Caution

Change the default password immediately. Go to User Settings (click your name in the top-right corner) and update your password.

2. Set up two-factor authentication

After changing your password, set up two-factor authentication (2FA) for your admin account:

1. Go to User Settings → Security.
2. Click Set Up Two-Factor Authentication.
3. Scan the QR code with an authenticator app (Google Authenticator, Authy, Microsoft Authenticator, etc.).
4. Enter the 6-digit code from the app to verify.
5. Save your backup codes in a secure location — you’ll need these if you lose access to your authenticator app.

2FA is required for all admin and manager accounts and the system will prompt until it’s enabled.

3. Configure branding

Navigate to Admin → Settings tab → Branding.

Setting	What to enter
Range Name	Your range or club name (e.g., “Greenfield Shooting Range”)
Address	Physical address — shown on the kiosk display
Weather Location	City name or coordinates for the kiosk weather widget
Terms & Conditions URL	Link to your terms page if you have one
Member Number Prefix	A short prefix for auto-generated member numbers (e.g., “GF-”)

Click Save after making changes.

4. Set operating hours

Still on the Settings tab, scroll to Operating Hours.

1. Toggle each day of the week as Open or Closed.
2. Set the Opening and Closing times for each open day.
3. Click Save.

Operating hours are displayed on the kiosk and used in reports.

5. Create membership types

Navigate to Admin → Billing section → Membership Types.

You need at least one membership type before you can add members. Click Add Membership Type and fill in:

Field	Example
Name	Annual Individual
Fee Amount	150.00
Initiation Fee	50.00
Duration (months)	12
Grace Period (days)	90
Benefits	Full range access, guest privileges
Default for New Members	Check if this is your primary membership

Create additional types as needed (e.g., Family, Junior, Lifetime, Senior).

Tip

Set one membership type as the Default for New Members — this pre-selects it on new-member forms and the kiosk enrollment screen, reducing friction.

6. Set up range fees

Navigate to Admin → Billing section → Range Fees.

Range fees are used for walk-in guests and day-use visitors. Click Add Range Fee and configure:

Field	Example
Name	Adult Walk-In
Price	25.00
Duration (minutes)	Leave blank for All Day
Description	Full day access, all lanes

Create fees for each pricing tier (e.g., Youth, Senior, Military).

7. Configure lanes

Navigate to Admin → Range section → Lanes.

Create distance presets first

Under Distances, add your distance options:

• 25 yards
• 50 yards
• 100 yards

Then create lanes

Click Add Lane for each physical lane at your range:

Field	Example
Lane Number	1
Lane Name	Pistol Bay 1
Disciplines	Pistol, Rifle
Distances	25 yards, 50 yards

Repeat for all lanes. The sort order controls how lanes appear on the kiosk display.

8. Set up training courses (optional)

Navigate to Admin → Range section → Training Courses.

If your range tracks safety certifications, create course records:

Field	Example
Name	Basic Pistol Safety
Description	NRA Basic Pistol course
Default Expiration (months)	24

Course completions can be recorded on individual member profiles.

9. Define club positions (optional)

Navigate to Admin → People section → Club Positions.

If your club has officer roles, create them here:

Field	Example
Name	President
Description	Club president
Linked Membership Type	Lifetime (optional — auto-assigns membership)

Positions can be assigned to members on their profile.

10. Create staff accounts

Navigate to Admin → People section → Users.

Create accounts for your team:

1. Click Add User.
2. Fill in the user’s name, email, and a temporary password.
3. Assign the appropriate role:
   • Admin — Full system access (club leadership, IT staff)
   • Manager — Member management, payments, reports (office staff)
   • RSO — Check-in, RSO portal, shift management (range safety officers)
4. Optionally link the account to a member record.

Share the login credentials with each user. They’ll be prompted to set up 2FA on first login (admin and manager roles).

11. Configure email (optional)

Navigate to Admin → System section → Email.

If you want to send renewal reminders, welcome emails, and payment receipts:

1. Toggle SMTP Enabled on.
2. Enter your SMTP server details:

Field	Example
Host	smtp.resend.com
Port	587
Username	resend
Password	re_xxxxxxxxxx
From Address	[email protected]
From Name	Greenfield Range
Application URL	https://range.yourclub.org

3. Click Save, then click Send Test Email to verify the connection.

Customize email templates

Navigate to Admin → System section → Email Templates.

Review the default templates and customize the subject lines and body text to match your club’s voice. You can toggle individual email types on or off.

Configure renewal reminders

In Admin → Settings, set renewal_reminder_days to control when reminders are sent (e.g., 30,14,7 sends reminders at 30, 14, and 7 days before expiry).

12. Set up Stripe payments (optional)

If you want to accept card payments via QR code at the kiosk or online renewal:

1. Create a Stripe account if you don’t have one.
2. In Admin → Settings → Other Settings, enter:
   • Stripe Public Key — Your publishable key (pk_live_...)
   • Stripe Secret Key — Your secret key (sk_live_...)
   • Stripe Webhook Secret — Set up a webhook in your Stripe dashboard pointing to https://yourdomain.com/api/webhooks/stripe and paste the signing secret here.
3. Click Save.

When Stripe is configured, members and guests can pay via QR code during kiosk check-in, and renewal reminder emails include a direct payment link.

13. Enable feature modules

Navigate to Admin → Modules tab.

Range Warden uses a module system to enable or disable major features. Review each module and toggle on the ones you need:

Module	What it enables
Payments	Payment recording, refunds, Stripe integration
Range Ops	Lane management, range status
Check-In	Member and guest check-in (requires Range Ops)
RSO	RSO shifts, portal, approval queue (requires Check-In)
RSO Scheduling	Monthly RSO shift calendar (requires RSO)
Training	Training course tracking
Kiosk	Self-service kiosk for members and guests (requires Check-In)
Email	Email templates and notifications
Reports	Analytics dashboards

Modules have dependencies — the system prevents you from enabling a module if its dependencies are disabled.

14. Pair kiosk devices (optional)

If you’re setting up self-service kiosk tablets:

1. Navigate to Admin → Range section → Kiosk → Device Tokens.
2. Click Add Device and give it a name (e.g., “Front Desk iPad”).
3. A 6-digit pairing code appears.
4. On the tablet, open a browser and navigate to your Range Warden kiosk URL (e.g., https://range.yourclub.org/self-service).
5. Enter the pairing code to link the device.

The tablet is now paired and can operate the kiosk without a staff login. See Self-Service Kiosk for usage details.

15. Set RSO policy (optional)

In Admin → Settings → RSO Policy, select the membership type that should be automatically assigned to RSO members. This ensures RSOs always have an active membership.

Setup complete

Your Range Warden instance is ready to use. Here’s what to do next:

• Add your members — Create member records or import from a CSV.
• Configure the kiosk — Set up check-in messages and announcements.
• Start checking in visitors — Begin daily range operations.
• Explore reports — Review your dashboard and analytics.