Signup/ Login to Sparrow

The signup/login system in Sparrow is designed to be secure, seamless, and accessible across web and desktop environments. Whether you're a first-time user or returning via a different device, this manual will guide you through the authentication options available.

What Makes Sparrow’s Login System Special?

• Magic Code (Passwordless) Login: Fast and frictionless access without needing a password.
• Google SSO Support: One-click login for users with Google accounts.
• Multiple Entry Points: Works seamlessly on web and desktop app.
• Personalized Experience: Dynamic messaging and redirections depending on user context.

Downloading the Application

You can download the Sparrow application via the Sparrow website by hitting the "Download" button for respective operating system. Once downloaded, install the application by following the steps displayed on the screen.

Signup Flow Overview

A typical account creation journey includes:

1. Entering your email ID
2. Providing your basic details such as:
   • First Name
   • Last Name
   • Password
3. Verification and redirection
   • Redirect to desktop or web app accordingly

How It Works:

• Click Login or Create

• Enter your email ID and click Continue

• Provide your Name and the Password you would want to use to login

• Receive a 6-digit Code on your email (valid for 5 minutes)

• Enter the code to proceed
• You’re logged in automatically and redirected to your workspace

info

In case you are not redirected to the web browser from the desktop application to continue the journey, copy the link in the desktop application and paste it in the browser.

Login Flow Overview

A typical login journey includes:

1. Entering your email ID
2. Choosing an authentication method:
   • Magic code
   • Password
   • Google
3. Verification and redirection:
   • Code verification or password input
   • Redirect to desktop or web app accordingly

Let’s dive into each flow.

Login with Magic Code

This is the default and most secure login method in Sparrow.

How It Works:

• Click Login or Create

• Enter your registered email ID and click “Send Magic Code”

• Receive a 6-digit Magic Code on your email (valid for 5 minutes)

• Enter the code to proceed
• You’re logged in automatically and redirected to your workspace or app

Benefits:

• No password needed
• Faster onboarding
• More secure than traditional login

Available On:

• Web
• Desktop App

Login with Password

You would have created during the profile setup, you can log in using it.

How It Works:

• Enter your registered email ID and click “Continue”

• Enter your password and login

Password Requirements:

• Minimum 8 characters
• At least one number
• At least one special character

info

If you originally signed up via Google, you can login using Google instead.

Forgot Password Flow

Forgot your password? You can reset it securely.

How It Works:

• Click “Forgot Password?” on the password entry screen

• Enter your registered email

• Receive a 6-digit verification code via email and click "Send Code"

• Enter the code

• Create a new password

• Redirects you to login automatically after success

info

You can resend the verification code if needed.

Resend Magic Code

Didn't receive the magic code or entered the wrong one? Use the resend option.

How It Works:

• After the first code is sent, you can click “Resend Code” on any of the code screen
• A new 6-digit Code is sent to your email
• Use the latest code

Cooldown Logic:

• Maximum 3 resend attempts per 30 minutes
• After 3 attempts, login is locked for 30 minutes (cooldown)

Login with Google (SSO)

Sparrow supports one-click Google login with OAuth.

How It Works:

• Click the Google icon on the screen

• Select or authenticate your Google account
• Accept permissions and terms
• You're logged in and redirected automatically in case the google account exists with Sparrow

First-Time Users:

• You’ll be prompted to enter your first/last name and agree to Sparrow’s terms
• Password creation is optional (you'll continue logging in with Google)

Returning Users:

• If your email is recognized, you’ll be logged in to Sparrow.

Final Notes

• After successful login, you’re directed to Workspace screen for you to try out the core Sparrow features.

• In case you are not redirected automatically to the desktop application post successful login, you can copy the token generated and paste it in the desktop application to login to Sparrow.

Need help logging in? Click the “Need Help?” button on any login screen or contact us at contactus@sparrowapp.dev.