Quick Start Guide

Quick Start Guide

Get up and running with Align in under five minutes.

1. Sign Up or Log In

Head to /signup to create your free Align account. You can sign up with your email or use GitHub OAuth for a faster setup. If you already have an account, log in to access your dashboard.

Tip
Signing up with GitHub automatically connects your account, saving you a step later when you want to create pull requests.

2. Add Your First Site

Once you're in the dashboard, click the Add Site button in the left panel. Enter the full URL of the website you want to analyze (e.g., https://example.com). Align will validate the URL and add it to your site list.

Tip
You can also explore the platform using the built-in demo sites before adding your own.

3. Run Your First Scan

With your site selected, click the Run Scan button at the top of the center panel. Align will crawl your page and run a full analysis covering SEO fundamentals, structured data, AI readiness, and more. The scan typically completes in 15–30 seconds.

While the scan is running, you'll see a progress indicator. Once complete, your results will load automatically across all analysis tabs.

4. Review Your SEO Score and Issues

After the scan finishes, you'll see your overall SEO score on a 0–100 scale along with a letter grade from A to F. The center panel displays your results organized into tabs:

  • SEO X-Ray — Title tags, meta descriptions, OG tags, headings, and images.
  • Schema — JSON-LD structured data detection and recommendations.
  • AI Readiness — How well your site is prepared for AI crawlers and citation.
  • GEO Score — Your visibility across AI engines like ChatGPT, Perplexity, Claude, and Gemini.

Each issue is flagged with a severity level so you can prioritize what to fix first.

5. Connect GitHub

To enable automated fixes, connect your GitHub account. Go to Settings > Connect GitHub and authorize Align through the GitHub OAuth flow. Then install the Align GitHub App on your repository to grant write access.

Once connected, link the repository that contains your website's source code to the site in your dashboard.

Note
For a detailed walkthrough of the GitHub integration, see the Connecting GitHub guide.

6. Create Your First PR

In the right panel, you'll see a list of fixable issues from your scan. Select the issues you want Align to resolve, then click the Create PR button. Align's AI agent will generate the code changes and open a pull request on your linked GitHub repository.

Review the PR on GitHub, check the diff, and merge when you're satisfied. After merging, run another scan to see your improved score.

Tip
Each issue shows a safety score so you know how confident Align is in the proposed fix before you create the PR.

Next Steps

Now that you've completed your first scan and fix, explore more of what Align offers: