Creating Projects

Organize your smart contracts into projects for better management. Projects group related contracts together: - All contracts for a protocol - Contracts that...

Last updated: January 14, 2026

Creating Projects

Organize your smart contracts into projects for better management.

What Are Projects?

Projects group related contracts together:

  • All contracts for a protocol
  • Contracts that share dependencies
  • Contracts deployed together
  • Versions of the same contract

Benefits of Projects

Organization

  • Keep related contracts together
  • Easy navigation
  • Clean dashboard

Shared Context

  • Common settings
  • Related vulnerability tracking
  • Project-level analytics

Team Collaboration

  • Project-level permissions
  • Assign teams to projects
  • Track progress per project

Creating a Project

From Dashboard

  1. Click Projects in navigation
  2. Click New Project
  3. Enter project details:
    • Name (required)
    • Description (optional)
    • Tags (optional)
  4. Click Create

From Upload

When uploading a contract:

  1. Click Add to Project
  2. Select Create New Project
  3. Enter project name
  4. Complete upload

Project Settings

Basic Information

Field Description
Name Project name
Description What this project contains
Tags Categories for filtering
Icon Visual identifier

Default Scan Settings

Set defaults for all project scans:

  • Scanner preset
  • Custom scanner selection
  • Notification preferences

Team Access

On team plans:

  • Assign project to team
  • Set permission level
  • Control visibility

Adding Contracts

To Existing Project

  1. Go to Contracts
  2. Select contracts (checkboxes)
  3. Click Move to Project
  4. Choose project
  5. Click Move

During Upload

  1. Start upload
  2. Click Add to Project
  3. Select existing project
  4. Complete upload

Drag and Drop

  1. Open project
  2. Drag contracts from list
  3. Drop into project

Project Structure

Flat Structure

All contracts at same level:

MyProject/
├── Token.sol
├── Vault.sol
└── Governor.sol

With Categories

Use tags for organization:

MyProject/
├── [core] Token.sol
├── [core] Vault.sol
├── [governance] Governor.sol
└── [test] MockToken.sol

Project Dashboard

Each project has its own dashboard showing:

Overview

  • Total contracts
  • Recent scans
  • Finding summary
  • Activity timeline

Statistics

  • Findings by severity
  • Trend over time
  • Fix rate

Quick Actions

  • New scan (all contracts)
  • Add contract
  • Invite team member

Managing Projects

Edit Project

  1. Go to Projects
  2. Click project name
  3. Click Settings (gear icon)
  4. Update details
  5. Click Save

Archive Project

For inactive projects:

  1. Go to project settings
  2. Click Archive
  3. Project moves to Archived section

Delete Project

  1. Go to project settings
  2. Click Delete
  3. Confirm deletion

Warning: This deletes all contracts and scan data.

Project Scans

Scan Entire Project

Scan all contracts at once:

  1. Open project
  2. Click Scan Project
  3. Select scanners
  4. Click Start

This creates one scan covering all contracts.

Individual Scans

Scan specific contracts:

  1. Open project
  2. Select contracts
  3. Click Scan Selected

Project Analytics

Project-Level Metrics

View aggregated data:

  • Total vulnerabilities
  • Severity distribution
  • Resolution progress
  • Scan frequency

Compare to Baseline

Track improvements:

  • Initial scan baseline
  • Current state
  • Trend direction

Export Reports

Generate project reports:

  • All findings across contracts
  • Progress over time
  • Team contributions

Project Limits

By Plan

Plan Projects
Free 3
Developer 5
Startup 20
Professional Unlimited
Enterprise Unlimited

Contracts per Project

No limit on contracts per project.

Best Practices

Naming

Use clear, descriptive names:

  • Good: "UniswapV3 Fork", "NFT Marketplace"
  • Bad: "Project 1", "test"

Grouping

Group by:

  • Protocol or product
  • Deployment target
  • Development stage

Tags

Use consistent tags:

  • production, staging, development
  • audited, pre-audit
  • v1, v2, v3

FAQ

Q: Can a contract be in multiple projects?
A: No. Each contract belongs to one project.

Q: What happens if I delete a project?
A: All contracts and scan history in the project are deleted.

Q: Can I transfer a project to another organization?
A: Contact support for project transfers.

Q: Are archived projects counted against my limit?
A: Archived projects count until deleted.

Next Steps