Please take a look at an example here:

https://github.com/TheBrainFamily/cypress-cucumber-example

Important steps:

Install this plugin:

npm install --save-dev cypress-cucumber-preprocessor

Put your step definitions in cypress/support/step_definitions

Examples: cypress/support/step_definitions/google.js

const {given} = require('cypress-cucumber-preprocessor')

// you can have external state, and also require things!
const url = 'https://google.com'

given('I open Google page', () => {
  cy.visit(url)
})

cypress/support/step_definitions/shared.js

const {then} = require('cypress-cucumber-preprocessor')

then(`I see {string} in the title`, (title) => {
  cy.title().should('include', title)
})

The requires are optional - you can just use

/* global then, when, given */

to make IDE happy

Your feature file in cypress/integration:

Example: cypress/integration/Facebook.feature

Feature: The Facebook

  I want to open a social network page

  Scenario: Opening a social network page
    Given I open Facebook page
    Then I see "Facebook" in the title

Add it to your plugins:

cypress/plugins/index.js

const cucumber = require('cypress-cucumber-preprocessor').default
module.exports = (on, config) => {
  on('file:preprocessor', cucumber())
}

Run your cypress the way you would normally do :) click on a .feature file on the list of specs, and see the magic happening!

This is a very fresh code, please let me know if you find any issues or have suggestions for improvements.

Scenario Outline support ( #12 )

Make compatible with Linux ( #10 ) - needs a replacement or disabling of fsevents

(Maybe?) Option to customize mocha template ( #3 )

Based/inspired on great work on https://github.com/sitegeist/gherkin-testcafe , although, with this package we don't have to run cypress programatically - with an external runner, we can use cypress as we are used to :)

Thanks to the Cypress team for the fantastic work and very exciting tool! :-)

Thanks to @fcurella for fantastic work with making the preprocessor reactive to file changes. :-)