Docs/Projects

Projects

Projects are the top-level organizational unit in Mock Studio. Each project contains its own mocks, folders, scenarios, and environments.

Creating a Project

  1. Navigate to the Projects page
  2. Click "New Project"
  3. Enter a project name
  4. Click Create

You can create as many projects as you need — one per API, service, or feature area.

Project Details

Click on any project to open its detail view. Here you can:

  • Rename the project by editing the name field
  • View all mocks organized by folders
  • Create new mocks and folders
  • Manage scenarios for the project
  • Configure environments with variables
  • View change history with rollback support

Folders

Organize mocks within a project using folders:

  1. Click "New Folder" in the project details
  2. Enter a folder name (3-30 characters)
  3. Drag and drop mocks between folders

Folders can be toggled on/off to enable or disable all mocks within them.

Import & Export

Export a Project

Export a single project as a JSON file for sharing or backup:

  1. Open the project
  2. Click Export from the project actions menu
  3. A .json file will be downloaded

Import a Project

Import a previously exported project:

  1. From the project details page, use Import in the actions
  2. Select a valid Mock Studio project JSON file
  3. The project will be imported with all mocks, folders, and scenarios

OpenAPI Import

Bootstrap mocks from an OpenAPI/Swagger specification:

  1. Open the project details
  2. Click Import OpenAPI from the actions menu
  3. Paste your OpenAPI spec (JSON or YAML)
  4. Mock Studio will generate mocks for each endpoint defined in the spec

GitHub Sync

Sync your project to a GitHub repository for version control and team collaboration:

  1. In project settings, configure your GitHub repository details:

- Owner, Repository, Branch, Path

- Personal Access Token (optional, for private repos)

  1. Push — Export project data to the configured GitHub repo
  2. Pull — Import the latest data from GitHub, overwriting local data

This enables team workflows where multiple developers share the same mock definitions.

Change History

Mock Studio tracks changes to your mocks automatically:

  • Every create, update, and delete operation is logged
  • View the change history in the project details
  • Rollback to a previous state if needed