> For the complete documentation index, see [llms.txt](https://craftacademy.gitbook.io/coding-as-a-craft-2-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://craftacademy.gitbook.io/coding-as-a-craft-2-0/configuring-rspec.md).

# Configuring RSpec

The following assumes that you've generated a middleman project using the its CLI `middleman init your_project_name`

## Update your Gemfile

Add the following gems to your `Gemfile` and run `bundle install`

```ruby
group :development, :test do
  gem 'capybara'
  gem 'pry'
  gem 'pry-byebug'
  gem 'rspec'
end
```

## Setup RSpec

From your terminal, navigate to your project directory and initialize RSpec config files for your project with the following command

`rspec --init`

Update the `.rspec` file to have the following code

```ruby
--format documentation
--color
--require spec_helper
```

Then remove all content in spec/spec\_helper.rb and replace with the following

```ruby
require 'rspec'
require 'capybara/rspec'

require 'middleman-core'
require 'middleman-core/rack'
require 'middleman-autoprefixer'
require 'middleman-livereload'

middleman_app = ::Middleman::Application.new

Capybara.app = ::Middleman::Rack.new(middleman_app).to_app do
  set :root, File.expand_path(File.join(File.dirname(FILE), '..'))
  set :environment, :development
  set :show_exceptions, false
end
```

With this in place we should now be ready to write our first spec

## Feature specs

Most of the specs you'll be writing for a middleman app will be feature specs that test for certain things to be visible on the page. Below is a sample feature spec that checks if projects are listed on the index page

```ruby
describe 'Index Page', type: :feature do
  it 'displays project list' do
    expect(page).to have_css '.projects'

    within '.projects' do
      expect(page).to have_content 'My First Website'
      expect(page).to have_content 'FizzBuzz'
    end
  end
end
```