Authentication & Setup
Getting started with Basestack Feature Flags begins with authentication. This guide will walk you through signing in and setting up your account.
Signing In
Navigate to Sign In
Visit the Basestack Feature Flags application and click on the Sign In button or navigate to the sign-in page.
The sign-in page displays:
- Welcome panel with product information
- Available authentication providers
- Terms of Service and Privacy Policy links
Choose Authentication Method
Basestack Feature Flags supports multiple authentication providers:
- OAuth Providers - Sign in with Google, GitHub, or other configured providers
- Email Authentication (Coming soon) - Use your email address
The available authentication methods depend on your instance configuration. Contact your administrator if you need access to additional providers.
Complete Authentication
Follow the prompts for your chosen authentication method:
- OAuth: You'll be redirected to the provider's login page, then back to Basestack
- Email (Coming soon): Enter your email, then verify if required
If you see an "Account not linked" error, it means you're trying to sign in with a different provider than the one already linked to your email address. Use the original provider or contact support.
First-Time Setup
After signing in for the first time, you'll be taken to the dashboard. Here's what you'll see:
Dashboard Overview
The dashboard provides:
- Account Insights - Usage meters showing your current subscription status and resource usage
- Recent Projects - Quick access to your recently accessed projects
- Teams - Teams you're a member of
- Quick Links - Helpful resources and SDK setup instructions
If you don't have an active subscription, you'll see a banner notification. You can still use Projects, Feature Flags, and Teams, but API endpoints will be disabled until you add billing details.
Account Settings
Access your account settings by clicking on your profile in the navigation bar, then selecting Account Settings.
General Settings
In the General tab, you can:
- Profile Information - View and update (Coming soon) your avatar, name, and email
- Modal Behavior - Toggle whether modals close when clicking outside
- Theme - Switch between light and dark mode
Billing Settings
In the Billing tab, you can:
- Current Plan - View your subscription plan and status
- Usage Meters - Monitor your resource usage:
- Projects
- Flags
- Teams
- Environments
- Members
- API Requests
Make sure to add billing details if you want to use API endpoints. Without an active subscription, endpoints will be disabled.
Navigation Overview
Once authenticated, you'll see the main navigation with:
- Projects Dropdown - Select and switch between projects
- Navigation Links:
- Feature Flags - Manage flags in the current project
- Settings - Project settings (General, Members, Environments, Security)
- Profile - Your account settings
- User Menu - Access account settings, billing, and logout
Next Steps
Now that you're authenticated and familiar with the dashboard:
Troubleshooting
Account Not Linked Error
If you see an "Account not linked" error:
- You're trying to sign in with a different provider than the one already linked to your email
- Use the original authentication provider
- Contact support if you need to link a different provider
Can't Access Features
If you can't access certain features:
- Check your subscription status in Account Settings → Billing
- Ensure you have the necessary permissions for the project
- Verify that API endpoints are enabled (requires active subscription)
Security Best Practices
- Enable two-factor authentication if available (Coming soon)
- Regularly review your account settings
- Keep your authentication provider accounts secure
- Don't share your API keys or project keys