Documentation

Community Workflows

Export your workflows to share with others, import workflows from files, or browse ready-to-use workflows from the community repository.

Exporting Workflows

Workflows can be exported as JSON files for backup or sharing:

  1. Open the workflow card menu (three dots)
  2. Click Download as JSON
  3. The workflow with all nodes and edges will be exported as a structured JSON file
  4. Use this format for importing into another workspace or sharing with the community

Importing Workflows

Import workflows from JSON files:

  1. Click the Import button next to "New Workflow"
  2. Drag and drop a JSON file or click to browse
  3. The system validates the JSON structure
  4. Preview shows workflow name, description, and node count
  5. Click Import Workflow to create the workflow

Note: If a workflow with the same name exists, it will be auto-renamed (e.g., "My Workflow" → "My Workflow (2)").

Community Repository

Don't want to start from scratch? Browse ready-to-use workflows created by the community:

Community Repository

Visit github.com/instructionly/community/workflows to discover workflow examples for code reviews, deployments, bug fixes, and more. Download JSON files and import them directly into your workspace.

Using Community Workflows

  1. Browse the workflows directory
  2. Find a workflow that matches your needs
  3. Download the JSON file
  4. Import it using the Import button in your workspace

JSON Format

Workflow JSON files follow this structure:

{
  "name": "Bug Fix",
  "description": "Simple workflow for fixing a bug",
  "nodes": [
    {
      "type": "start",
      "title": "Bug Reported",
      "description": "A bug has been identified",
      "positionX": 250,
      "positionY": 50
    },
    {
      "type": "action",
      "title": "Investigate",
      "description": "Reproduce and identify root cause",
      "positionX": 250,
      "positionY": 150
    }
  ],
  "edges": [
    { "sourceNodeIndex": 0, "targetNodeIndex": 1 }
  ]
}

Edges use sourceNodeIndex and targetNodeIndex (0-based) to reference nodes in the nodes array.

Contributing Your Workflows

Have workflows that work well for your team? Share them with the community:

  1. Export your workflow as JSON
  2. Fork the community repository
  3. Add your workflow to workflows/examples/
  4. Update the README catalog
  5. Submit a pull request

See the Contributing Guide for detailed instructions.