Quickstart: Run your first analysis

## Quickstart: Run your first analysis

This guide walks you through running your first SyntaxValid analysis in 5–10 minutes.

By the end of this guide, you will:

- Connect a repository

- Run an analysis

- Understand the results

- Know what to fix first

---

## Step 1: Sign in and open the Dashboard

After signing in, you will land on the Dashboard.

From here, you can:

- View existing projects

- See recent analyses

- Monitor TrustScore changes over time

If this is your first time using SyntaxValid, the Dashboard will be empty.

---

## Step 2: Create your first project

1. Go to Projects

2. Click New Project

3. Select your GitHub repository

4. Confirm access permissions

Once connected, SyntaxValid will prepare the repository for analysis.

> Tip: Start with a small or medium-sized repository for your first run.

---

## Step 3: Run an analysis

1. Open your project

2. Click Run Analysis

3. Choose the analysis type:

- Full repository – analyzes the entire codebase

- Diff / Pull Request – analyzes only recent changes

4. Start the analysis

The analysis status will appear as Running.

Most analyses complete within a few minutes.

---

## Step 4: Review the results

When the analysis finishes, you will see:

- TrustScore – overall risk and health signal

- Issues – detected security, quality, and architecture problems

- Blocking status – issues that prevent safe merging

Focus first on blocking issues, as these have the highest impact.

---

## Step 5: Fix critical issues

For each issue, you can:

- Review details and recommendations

- Apply fixes manually

- Use Fix with AI to generate a safe, reviewable patch

Fix with AI never applies changes automatically.

You remain in full control.

---

## Step 6: Re-run analysis and confirm

After applying fixes:

1. Re-run the analysis

2. Verify that blocking issues are resolved

3. Observe the TrustScore improvement

A clean analysis indicates that the code is safe to merge.

---

## What’s next?

- Learn how the analysis engine works

- Understand how TrustScore is calculated

- Integrate SyntaxValid into pull requests and your IDE

---

## Need help?

If something does not work as expected:

- Check the Troubleshooting section

- Review repository permissions

- Contact support from the Dashboard