Getting Started with Specwise

Everything you need to go from requirements to tested software.

Getting Started

  1. Sign up at specwise.wearesnx.studio/signup
  2. Create your organization — give it a name and you'll be taken to your dashboard at specwise-app.wearesnx.studio
  3. You'll start on the Free plan — no credit card required. Upgrade to Starter or Growth (each with a 14-day free trial) whenever you need more.

Create a Project

Projects are your workspace for all testing activity. To create one:

  1. Click "New Project" from the Projects page
  2. Fill in the details:
    • Project name — a descriptive name for your project
    • Industry — helps AI generate more relevant test cases
    • Target URL— the application you're testing
  3. Your project is now ready — all test cases, documents, and runs live here

Upload a BRD

Specwise can parse your business requirements documents and extract testable requirements automatically.

  1. Navigate to your project and open the Documents tab
  2. Drag and drop a PDF or DOCX file
  3. Specwise parses the document, extracting sections and tables
  4. Click "Extract Requirements" to have AI identify requirements from the document

AI Test Generation

Let AI turn your requirements into comprehensive test cases.

  1. From any project, use the AI Assistant or click "Generate with AI" on the Test Cases tab
  2. Describe what you want to test, or let AI generate from your uploaded requirements
  3. Review each generated test case — accept, edit, or dismiss
  4. Generated test cases include:
    • Step-by-step instructions
    • Expected results for each step
    • Priority level
    • AI confidence score

Manual Testing

Execute test cases step-by-step with full traceability.

  1. Create a Test Run from the Test Runs tab
  2. Select which test cases to include in the run
  3. Execute step by step — mark each step pass or fail
  4. Add notes and attach evidence (screenshots, files) to any step

Discover Pages

Before Specwise can generate tests for your app, it needs to know which pages exist. There are two ways to capture them — no browser extension required.

Option 1: Bookmarklet

  1. Drag the Specwise Discover bookmarklet from your project's Settings page to your browser bookmark bar
  2. Navigate to each page of your application and click the bookmarklet
  3. The page URL and title are captured and sent to your project automatically

Option 2: Runner discovery mode

The Specwise runner can crawl your app and discover pages automatically. See the runner README for setup instructions and configuration options.

Once pages are discovered, they appear in the Pages tab of your project and are ready to use during test generation.

Test Runs

Test runs group test cases for a specific execution cycle.

  • Track progress across statuses: total, passed, failed, blocked, and skipped
  • View detailed results per test case with attached evidence
  • Compare runs over time to measure testing coverage and regression

API Reference

Full API documentation is coming soon. In the meantime, check out our OpenAPI docs at api.specwise.wearesnx.studio/docs.