Getting Started
Managing Projects
Learn how to create, organize, and manage testing projects for your web applications.
Managing Projects
Projects are the foundation of AegisRunner. Each project represents a website or application you want to test, and contains all related crawls, test suites, and runs.
Plan Limits
| Plan | Max Projects |
|---|---|
| Free | 1 project |
| Starter ($9/mo) | 3 projects |
| Pro ($29/mo) | 10 projects |
| Business ($59/mo) | 25 projects |
Viewing Projects
Navigate to Projects in the sidebar to see all your projects. The projects page offers:
- Grid View - Visual cards showing project details
- List View - Compact table format
- Search - Find projects by name
- Sort - Order by name, created date, updated date, or suite count
Project Card Information
Each project card displays:
- Project name
- Base URL domain
- Description (if provided)
- Number of test suites
- Team member count and avatars
- Manage button for member management
Creating a New Project
1
Click New Project
On the Projects page, click the + New Project button in the top right.
2
Enter Project Details
Fill in the required fields:
- Project Name (required) - A descriptive name for your project
- Base URL (required) - The root URL of your website (e.g.,
https://example.com) - Description (optional) - Additional context about the project
3
Create Project
Click Create Project to save.
Base URL Tips:
- Always include the protocol (
https://) - Don't include trailing slashes
- Use your production or staging URL
- The base URL determines the scope of crawls
Selecting a Project
Click on any project card to select it as your active project. Once selected:
- The project name appears in the header
- All views (Dashboard, Crawls, Suites, Runs) are filtered to that project
- New crawls and tests are associated with the project
Managing Team Members
Each project can have multiple team members (based on your plan limits):
| Plan | Team Members |
|---|---|
| Free | 1 (just you) |
| Starter | 1 |
| Pro | Up to 5 |
| Business | Up to 15 |
Adding Team Members
- Click the Manage button on a project card
- The member management slider opens
- View current members and their roles
- Invite new members by email
Member Roles
- Owner - Full control, can delete project and manage billing
- Admin - Can manage members and all project settings
- Member - Can run crawls and tests, but limited settings access
Editing a Project
To edit project settings:
- Select the project
- Go to project settings (gear icon or settings menu)
- Update the name, base URL, or description
- Save your changes
Deleting a Project
Warning: Deleting a project permanently removes all associated crawls, test suites, test runs, and data. This action cannot be undone.
To delete a project:
- Click the delete icon on the project card (or in project settings)
- A confirmation modal appears
- Type the project name to confirm
- Click Delete Project
Best Practices
Project Organization Tips:
- Create separate projects for production and staging environments
- Use descriptive names that identify the website/app
- Add descriptions to help team members understand the project scope
- Regularly review and clean up unused projects
Related Documentation
- Quick Start Guide - Create your first project
- Team Management - Detailed team administration
- Starting a New Crawl - Crawl your project