Nexmo Developer is a platform hosting the Nexmo documentation, API reference, SDKs, Tools & Community content.

• Ruby 2.4.1 + bundler
• PostgreSQL
• Yarn

$ git clone [email protected]:Nexmo/nexmo-developer.git
$ cd nexmo-developer
$ cp .env.example .env
$ bundle install
$ rake db:create
$ rake db:migrate
$ ./bin/yarn install
$ rails s

You should now be able to see the site on http://localhost:3000/

If you don't want to install Ruby & PostgreSQL then you can use docker to sandbox Nexmo Developer into its own containers. After you Install Docker run the following:

# Start the web server
$ docker-compose up

# Setup the Database (you only need to do this once)
$ docker-compose run web rake db:setup

# Open the browser
$ open http://localhost:3000

To stop the server cleanly run:

$ docker-compose down

• A powerful markup engine with pipeline (see this blog post for details on how this works).
• Automatically generated navigation based on the contents of _documentation.
• Turbolinks for progressively loading content into for a seamless user experience.

• Dynamic content for community section
• Interactive examples of the Nexmo APIs

Some examples require code from repos such as nexmo-community/nexmo-ruby-quickstart these repos can be defined in config/repos.yml as such:

nexmo-community/nexmo-ruby-quickstart: 'master'

The code can then be pulled into the .repo directory with the following command:

$ rake repos:pull

To pull a single repo provide the GitHub repo name and optional branch:

$ rake repos:pull nexmo-community/nexmo-ruby-quickstart master

This repository uses Yelp's Pre-Commit framework for managing shared pre-commit hooks.

These include checks to ensure syntactic validity of XML, JSON and YAML files, as well as unfinished merge conflicts and case conflicts in filenames.

This is optional. See the pre-commit website for installation instructions.

This is because Docker wasn't shut down cleanly. To fix this run:

$ docker-compose run web rm /myapp/tmp/pids/server.pid

This error indicates that PostgreSQL is not running. If you installed PostgreSQL using brew you can get information about how to start it by running:

$ brew info postgresql

Once PostgreSQL is running you'll need to create and migrate the database. See Setup for instructions.

Contributions are welcome, please follow GitHub Flow

The content of this project itself is licensed under the Creative Commons Attribution 4.0 International license, and the underlying source code used to format and display that content is licensed under the MIT license.