A project is one codebase Specsight watches: a repository and the branch it follows. You create your first during first-run setup; this article covers everything after that.
Create a project
Connect your code first (GitHub or GitLab). Then, from the organisation home, click New project and fill in the form:
- Connection — pick GitHub or GitLab, shown only when both are connected
- Repository — pick the repository to watch. If one is missing, your connection cannot see it yet
- Branch — pick the branch to follow
- Project name — name your project, or keep the repository name
- Context description — optional. A short summary of what the product does, which helps Specsight classify features
Specsight measures the codebase to check it fits your plan limits, then click Create project. The first analysis runs in the background. Small repositories finish in minutes; large ones can take up to an hour.
You can close the tab, Specsight emails you when the spec is ready.
Edit a project
Open a project and click Project settings in the project rail. It has three pages:
- General — the project name and context description. Click Save changes
- Repository — the connected repository and watched branch, read-only. To switch either, delete the project and create it again
- Danger zone — re-analyse or delete the project
Re-analyse the codebase
A re-analysis discards every scenario Specsight wrote and runs a full analysis from scratch. Your changelog starts again from it, so earlier releases no longer show. Use it when the codebase has moved so far that automatic syncs no longer reflect the product.
In Project settings → Danger zone, click Analyse again. If you have scenarios of your own, choose whether to keep them, then confirm with Yes, analyse again.
If the repository has grown past your plan limits, the analysis does not start. A Request a higher limit button appears instead.
A free trial doesn’t include re-analysis. It comes with your plan once the trial ends.
Delete a project
In Project settings → Danger zone, click Delete project and confirm.
During a free trial, your project can’t be deleted. Picked the wrong repository? Email ola@specsight.app and we’ll swap it.
Project limits
Standard covers 3 projects. At the limit, delete one you no longer need, or click Request a higher limit on the New project page. See plans and limits.
A free trial covers one project. To add more, click Start your plan now on the New project page and confirm. Your trial ends and your card is charged straight away.