Skip to content

Generate Entity-Relationship Diagrams for Rails applications

License

Notifications You must be signed in to change notification settings

d-ray/rails-erd

This branch is 150 commits behind voormedia/rails-erd:master.

Folders and files

NameName
Last commit message
Last commit date
Jun 15, 2011
Aug 10, 2016
Oct 15, 2015
Aug 10, 2016
Jun 13, 2016
Feb 24, 2011
Feb 9, 2015
Mar 20, 2015
Aug 10, 2016
Jun 19, 2015
Oct 15, 2015
Jan 1, 2015
Aug 10, 2016
Jul 19, 2012
May 14, 2015

Repository files navigation

Rails ERD - Generate Entity-Relationship Diagrams for Rails applications

Build Status Code Climate

Rails ERD is a gem that allows you to easily generate a diagram based on your application's Active Record models. The diagram gives an overview of how your models are related. Having a diagram that describes your models is perfect documentation for your application.

The second goal of Rails ERD is to provide you with a tool to inspect your application's domain model. If you don't like the default output, it is very easy to use the API to build your own diagrams.

Rails ERD was created specifically for Rails and works on versions 3.0-5.0. It uses Active Record's built-in reflection capabilities to figure out how your models are associated.

Preview

Here's an example entity-relationship diagram that was generated by Rails ERD:

Entity-Relationship Diagram

Browse the gallery for more example diagrams.

Requirements

  • Ruby 1.9.3+
  • ActiveRecord 3.x

Getting started

See the installation instructions for a complete description of how to install Rails ERD. Here's a summary:

  • Install Graphviz 2.22+ (how?)

  • Add gem "rails-erd" to your application's Gemfile

  • Run bundle exec erd

Configuration

Rails ERD has the ability to be configured via the command line or through the use of a YAML file with configuration options set. It will look for this file first at ~/.erdconfig and then ./.erdconfig (which will override any settings in ~/.erdconfig). The format of the file is as follows (shown here with the default settings used if no .erdconfig is found). More information on customization options can be found in Rails ERD's project documentation.

attributes:
  - content
  - foreign_key
  - inheritance
disconnected: true
filename: erd
filetype: pdf
indirect: true
inheritance: false
markup: true
notation: simple
orientation: horizontal
polymorphism: false
sort: true
warn: true
title: sample title
exclude: null
only: null
only_recursion_depth: null
prepend_primary: false
cluster: false

Learn more

More information can be found on Rails ERD's project homepage.

If you wish to extend or customise Rails ERD, take a look at the API documentation.

About Rails ERD

Rails ERD was created by Rolf Timmermans (r.timmermans at voormedia.com)

Copyright 2010-2015 Voormedia - www.voormedia.com

License

Rails ERD is released under the MIT license.

About

Generate Entity-Relationship Diagrams for Rails applications

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 98.4%
  • Other 1.6%