Ruby on Rails — A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern.

<!doctype html> <html lang="en"> <head> <title>Ruby on Rails — A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern.</title> <meta charset="utf-8" /> <meta content="ie=edge" http-equiv="x-ua-compatible" /> <meta name="handheldfriendly" content="true" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="description" content="A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern." /> <meta property="og:site_name" content="Ruby on Rails" /> <meta property="og:title" content="Ruby on Rails" /> <meta property="og:description" content="A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern." /> <meta property="og:image" content="https://rubyonrails.org/assets/images/opengraph.png" /> <meta property="og:url" content="https://rubyonrails.org/" /> <meta property="og:type" content="website" /> <meta name="twitter:title" content="Ruby on Rails" /> <meta name="twitter:description" content="A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern." /> <meta name="twitter:image" content="https://rubyonrails.org/assets/images/opengraph.png" /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:creator" content="@rails" /> <meta name="twitter:image:alt" content="Ruby on Rails" /> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebPage", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://rubyonrails.org/" }, "name": "Ruby on Rails", "headline": "Ruby on Rails", "description": "A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern.", "url": "https://rubyonrails.org/", "image": "https://rubyonrails.org/assets/images/opengraph.png" } </script> <script defer data-domain="rubyonrails.org" src="https://plausible.io/js/script.js"></script> <link rel="icon" href="/assets/images/favicon.png" /> <link rel="stylesheet" href="/assets/css/style.css" /> <link rel="alternate" type="application/rss+xml" href="/feed.xml" title="The official Ruby on Rails blog"> </head> <body> <div class="banner text--align-center"> <p> <a class="common-button--text" href="https://guides.rubyonrails.org/getting_started.html" target="_blank"> [New Getting Started Tutorial] Build an e-commerce app with Rails 8. </a> </p> </div> <nav class="nav"> <a class="nav__logo" href="/" aria-label="Ruby on Rails"></a> <input class="nav__checkbox" id="nav__checkbox" type="checkbox" role="button" aria-label="menu" /> <label class="nav__toggle" for="nav__checkbox"> <span></span> </label> <div class="nav__options"> <div> <ul> <li><a href="https://github.com/rails/rails"><span>Source</span></a></li> <li><a href="/docs"><span>Docs</span></a></li> <li><a href="/community"><span>Community</span></a></li> <li><a href="/blog"><span>News</span></a></li> </ul> <ul> <li><a href="/world"><span>Events</span></a></li> <li><a href="https://jobs.rubyonrails.org"><span>Jobs</span></a></li> <li><a href="https://merch.rubyonrails.org"><span>Merch</span></a></li> <li><a href="/foundation"><span>Foundation</span></a></li> </ul> </div> </div> </nav> <div class="layout"> <div class="heading common-padding--bottom common-padding--top-small"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>Compress the complexity of modern web apps.</h1> <h4>Learn just what you need to get started, then keep leveling up as you go. <strong>Ruby on Rails scales from HELLO WORLD to IPO.</strong></h4> </div> <div class="heading__button"> <a href="2024/12/13/Rails-Version-8-0-1-has-been-released" class="common-button common-button--version"><span>Rails 8.0.1 — released December 13, 2024</span></a> </div> </div> </div> </div> <div class="video common-background--grey common-shape--top-white-down-left"> <div class="container"> <div class="video__embed"> <video poster="https://d2biiyjlsh52uh.cloudfront.net/rails/rails-8-demo.webp" src="https://d2biiyjlsh52uh.cloudfront.net/rails/rails-8-demo.mp4" width="1920" height="1080" preload="metadata" controls crossorigin> <track src="https://d2biiyjlsh52uh.cloudfront.net/rails/rails-8-demo-en.vtt" kind="captions" label="English" srclang="en" default> </video> </div> </div> </div> <div class="heading common-gradient--grey-to-white common-padding--bottom-small common-padding--top"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>You鈥檙e in good company.</h1> <h4>Over the past two decades, Rails has taken countless companies to millions of users and billions in market valuations.</h4> </div> </div> </div> </div> <div class="trusted common-padding--bottom-small"> <div class="container"> <div class="trusted__blocks"> <div class="trusted__block"> <a href="https://basecamp.com" aria-label="Basecamp"> <img src="/assets/images/logo-basecamp.svg" alt="Basecamp" /> </a> </div> <div class="trusted__block"> <a href="https://hey.com" aria-label="HEY"> <img src="/assets/images/logo-hey.svg" alt="HEY" /> </a> </div> <div class="trusted__block"> <a href="https://github.com" aria-label="GitHub"> <img src="/assets/images/logo-github.svg" alt="GitHub" /> </a> </div> <div class="trusted__block"> <a href="https://shopify.com" aria-label="Shopify"> <img src="/assets/images/logo-shopify.svg" alt="Shopify" /> </a> </div> <div class="trusted__block"> <a href="https://instacart.com" aria-label="Instacart"> <img src="/assets/images/logo-instacart.svg" alt="Instacart" /> </a> </div> <div class="trusted__block"> <a href="https://dribbble.com" aria-label="Dribbble"> <img src="/assets/images/logo-dribbble.svg" alt="Dribbble" /> </a> </div> <div class="trusted__block"> <a href="https://gusto.com" aria-label="Gusto"> <img src="/assets/images/logo-gusto.svg" alt="Gusto" /> </a> </div> <div class="trusted__block"> <a href="https://zendesk.com" aria-label="Zendesk"> <img src="/assets/images/logo-zendesk.svg" alt="Zendesk" /> </a> </div> <div class="trusted__block"> <a href="https://airbnb.com" aria-label="Airbnb"> <img src="/assets/images/logo-airbnb.svg" alt="Airbnb" /> </a> </div> <div class="trusted__block"> <a href="https://squareup.com" aria-label="Square"> <img src="/assets/images/logo-square.svg" alt="Square" /> </a> </div> <div class="trusted__block"> <a href="https://kickstarter.com" aria-label="Kickstarter"> <img src="/assets/images/logo-kickstarter.svg" alt="Kickstarter" /> </a> </div> <div class="trusted__block"> <a href="https://heroku.com" aria-label="Heroku"> <img src="/assets/images/logo-heroku.svg" alt="Heroku" /> </a> </div> <div class="trusted__block"> <a href="https://coinbase.com" aria-label="Coinbase"> <img src="/assets/images/logo-coinbase.svg" alt="Coinbase" /> </a> </div> <div class="trusted__block"> <a href="https://soundcloud.com" aria-label="Soundcloud"> <img src="/assets/images/logo-soundcloud.svg" alt="Soundcloud" /> </a> </div> <div class="trusted__block"> <a href="https://cookpad.com" aria-label="Cookpad"> <img src="/assets/images/logo-cookpad.svg" alt="Cookpad" /> </a> </div> <div class="trusted__block"> <a href="https://www.doximity.com" aria-label="Doximity"> <img src="/assets/images/logo-doximity.svg" alt="Doximity" /> </a> </div> <div class="trusted__block"> <a href="https://www.intercom.com" aria-label="Intercom"> <img src="/assets/images/logo-intercom.svg" alt="Intercom" /> </a> </div> <div class="trusted__block"> <a href="https://www.fleetio.com" aria-label="Fleetio"> <img src="/assets/images/logo-fleetio.svg" alt="Fleetio" /> </a> </div> <div class="trusted__block"> <a href="https://li.me" aria-label="Lime"> <img src="/assets/images/logo-lime.svg" alt="Lime" /> </a> </div> <div class="trusted__block"> <a href="https://www.freeagent.com/" aria-label="FreeAgent"> <img src="/assets/images/logo-freeagent.svg" alt="FreeAgent" /> </a> </div> </div> </div> </div> <div class="text text--align-center common-padding--bottom"> <div class="container"> <div class="text__body"> <div class="text__content common-content common-content--size-large"> <p><strong>These are just a few of the big names.</strong> There have been many hundreds of thousands of apps created with Rails since its inception.</p> </div> </div> </div> </div> <div class="heading common-background--grey common-border--top common-padding--bottom common-padding--top"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>Building it together.</h1> <h4>Over six thousand people have <a href="https://contributors.rubyonrails.org">contributed code to Rails</a>, and many more have served the community through evangelism, documentation, and bug reports. Join us!</h4> </div> <div class="heading__button"> <a href="/community" class="common-button common-button--text common-button--icon-arrow"><span>Meet the Rails team</span></a> </div> </div> </div> </div> <div class="heading heading--frame-white common-padding--bottom common-shape--top-grey-down-left"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>Everything you need.</h1> <h4><strong>Rails is a full-stack framework.</strong> It ships with all the tools needed to build amazing web apps on both the front and back end.</h4> </div> <div class="heading__content heading__content--has-headline common-content common-content--size-large"> <p>Rendering HTML templates, updating databases, sending and receiving emails, maintaining live pages via WebSockets, enqueuing jobs for asynchronous work, storing uploads in the cloud, providing solid security protections for common attacks. Rails does it all and so much more.</p> </div> </div> </div> </div> <div class="example common-background--grey common-padding--bottom common-shape--top-white-down-right"> <div class="container"> <div class="example__body"> <div class="example__block example__block--align-left"> <div class="example__code common-code"> <h6>app/models/article.rb</h6> <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">class</span> <span class="nc">Article</span> <span class="o"><</span> <span class="no">ApplicationRecord</span> <span class="n">belongs_to</span> <span class="ss">:author</span><span class="p">,</span> <span class="ss">default: </span><span class="o">-></span> <span class="p">{</span> <span class="no">Current</span><span class="p">.</span><span class="nf">user</span> <span class="p">}</span> <span class="n">has_many</span> <span class="ss">:comments</span> <span class="n">has_one_attached</span> <span class="ss">:cover_image</span> <span class="n">has_rich_text</span> <span class="ss">:content</span><span class="p">,</span> <span class="ss">encrypted: </span><span class="kp">true</span> <span class="n">enum</span> <span class="ss">status: </span><span class="sx">%i[ drafted published ]</span> <span class="n">scope</span> <span class="ss">:recent</span><span class="p">,</span> <span class="o">-></span> <span class="p">{</span> <span class="n">order</span><span class="p">(</span><span class="ss">created_at: :desc</span><span class="p">).</span><span class="nf">limit</span><span class="p">(</span><span class="mi">25</span><span class="p">)</span> <span class="p">}</span> <span class="n">after_save_commit</span> <span class="ss">:deliver_later</span><span class="p">,</span> <span class="ss">if: :published?</span> <span class="k">def</span> <span class="nf">byline</span> <span class="s2">"Written by </span><span class="si">#{</span><span class="n">author</span><span class="p">.</span><span class="nf">name</span><span class="si">}</span><span class="s2"> on </span><span class="si">#{</span><span class="n">created_at</span><span class="p">.</span><span class="nf">to_s</span><span class="p">(</span><span class="ss">:short</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span> <span class="k">end</span> <span class="k">def</span> <span class="nf">deliver_later</span> <span class="no">Article</span><span class="o">::</span><span class="no">DeliveryJob</span><span class="p">.</span><span class="nf">perform_later</span><span class="p">(</span><span class="nb">self</span><span class="p">)</span> <span class="k">end</span> <span class="k">end</span></code></pre></figure> </div> <div class="example__content common-content"> <h3>Active Records make modeling easy.</h3> <p>Databases come to life with business logic encapsulated in rich objects. Modeling associations between tables, providing callbacks when saved, encrypting sensitive data seamlessly, and expressing SQL queries beautifully.</p> </div> </div> <div class="example__block example__block--align-left"> <div class="example__code common-code"> <h6>app/controllers/articles_controller.rb</h6> <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">class</span> <span class="nc">ArticlesController</span> <span class="o"><</span> <span class="no">ApplicationController</span> <span class="k">def</span> <span class="nf">index</span> <span class="vi">@articles</span> <span class="o">=</span> <span class="no">Article</span><span class="p">.</span><span class="nf">recent</span> <span class="k">end</span> <span class="k">def</span> <span class="nf">show</span> <span class="vi">@article</span> <span class="o">=</span> <span class="no">Article</span><span class="p">.</span><span class="nf">find</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="ss">:id</span><span class="p">])</span> <span class="n">fresh_when</span> <span class="ss">etag: </span><span class="vi">@article</span> <span class="k">end</span> <span class="k">def</span> <span class="nf">create</span> <span class="n">article</span> <span class="o">=</span> <span class="no">Article</span><span class="p">.</span><span class="nf">create!</span><span class="p">(</span><span class="n">article_params</span><span class="p">)</span> <span class="n">redirect_to</span> <span class="n">article</span> <span class="k">end</span> <span class="kp">private</span> <span class="k">def</span> <span class="nf">article_params</span> <span class="n">params</span><span class="p">.</span><span class="nf">require</span><span class="p">(</span><span class="ss">:article</span><span class="p">).</span><span class="nf">permit</span><span class="p">(</span><span class="ss">:title</span><span class="p">,</span> <span class="ss">:content</span><span class="p">)</span> <span class="k">end</span> <span class="k">end</span></code></pre></figure> </div> <div class="example__content common-content"> <h3>Action Controllers handle all requests.</h3> <p>Controllers expose the domain model to the web, process incoming parameters, set caching headers, and render templates, responding with either HTML or JSON.</p> </div> </div> <div class="example__block example__block--align-left"> <div class="example__code common-code"> <h6>app/views/articles/show.html.erb</h6> <figure class="highlight"><pre><code class="language-erb" data-lang="erb"><span class="nt"><h1></span><span class="cp"><%=</span> <span class="vi">@article</span><span class="p">.</span><span class="nf">title</span> <span class="cp">%></span><span class="nt"></h1></span> <span class="cp"><%=</span> <span class="n">image_tag</span> <span class="vi">@article</span><span class="p">.</span><span class="nf">cover_image</span><span class="p">.</span><span class="nf">url</span> <span class="cp">%></span> <span class="nt"><p></span><span class="cp"><%=</span> <span class="vi">@article</span><span class="p">.</span><span class="nf">content</span> <span class="cp">%></span><span class="nt"></p></span> <span class="cp"><%=</span> <span class="n">link_to</span> <span class="s2">"Edit"</span><span class="p">,</span> <span class="n">edit_article_path</span><span class="p">(</span><span class="vi">@article</span><span class="p">)</span> <span class="k">if</span> <span class="no">Current</span><span class="p">.</span><span class="nf">user</span><span class="p">.</span><span class="nf">admin?</span> <span class="cp">%></span></code></pre></figure> </div> <div class="example__content common-content"> <h3>Action Views mix Ruby and HTML.</h3> <p>Templates can use the full versatility of Ruby, excessive code is extracted into helpers, and the domain model is used directly and interwoven with the HTML.</p> </div> </div> <div class="example__block example__block--align-left"> <div class="example__code common-code"> <h6>config/routes.rb</h6> <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="no">Rails</span><span class="p">.</span><span class="nf">application</span><span class="p">.</span><span class="nf">routes</span><span class="p">.</span><span class="nf">draw</span> <span class="k">do</span> <span class="n">resources</span> <span class="ss">:articles</span> <span class="k">do</span> <span class="c1"># /articles, /articles/1</span> <span class="n">resources</span> <span class="ss">:comments</span> <span class="c1"># /articles/1/comments, /comments/1</span> <span class="k">end</span> <span class="n">root</span> <span class="ss">to: </span><span class="s2">"articles#index"</span> <span class="c1"># /</span> <span class="k">end</span></code></pre></figure> </div> <div class="example__content common-content"> <h3>Action Dispatch routes URLs.</h3> <p>Configure how URLs connect to the controllers using the routing domain language. Routes expose the bundle of actions that go together as a resource: index, show, new, create, edit, update, destroy.</p> </div> </div> </div> </div> </div> <div class="heading heading--frame-white common-background--grey common-shape--bottom-white-up-left"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>Optimized for happiness.</h1> </div> <div class="heading__content heading__content--has-headline common-content common-content--size-large"> <p>Rails has united and cultivated a strong tribe around a <strong>wide set of heretical thoughts</strong> about the nature of programming and programmers. Understanding these thoughts will help you understand the design of the framework.</p> </div> <div class="heading__button"> <a href="/doctrine" class="common-button common-button--text common-button--icon-arrow"><span>Read the Rails Doctrine</span></a> </div> </div> </div> </div> <div class="heading common-padding--bottom-small common-padding--top"> <div class="container"> <div class="heading__body"> <div class="heading__headline common-headline"> <h1>Let鈥檚 get started.</h1> </div> </div> </div> </div> <div class="cards common-padding--bottom-small"> <div class="container"> <div class="cards__container"> <div class="card"> <a href="https://guides.rubyonrails.org"> <div class="card__body"> <div class="card__label"> <h6>Learning</h6> </div> <div class="card__headline"> <h3>Read the guides.</h3> </div> <div class="card__content"> <p>Learn what the frameworks can do and how they fit together.</p> </div> </div> </a> </div> <div class="card"> <a href="https://github.com/rails/rails"> <div class="card__body"> <div class="card__label"> <h6>Contributing</h6> </div> <div class="card__headline"> <h3>Contribute on GitHub.</h3> </div> <div class="card__content"> <p>File bug reports and make pull-requests.</p> </div> </div> </a> </div> <div class="card"> <a href="/blog"> <div class="card__body"> <div class="card__label"> <h6>Keeping up</h6> </div> <div class="card__headline"> <h3>See what鈥檚 new.</h3> </div> <div class="card__content"> <p>The latest releases and updates on development.</p> </div> </div> </a> </div> </div> </div> </div> <div class="text text--align-center common-padding--bottom"> <div class="container"> <div class="text__body"> <div class="text__content common-content common-content--size-large"> <p>Learn more about <a href="https://hotwired.dev">Hotwire</a>, the default front-end framework for Rails.</p> <p><strong>Stay up to date</strong> with Rails on <a href="https://x.com/rails" class="icon icon--x">X</a>, <a href="https://www.youtube.com/@railsofficial" class="icon icon--youtube">YouTube</a>, and <a href="https://world.hey.com/this.week.in.rails" class="icon icon--world">This Week in Rails</a>.</p> </div> </div> </div> </div> </div> <footer class="footer common-background--grey common-padding--bottom common-padding--top common-shape--top-white-up-left"> <div class="footer__logo"><a href="/" aria-label="Ruby on Rails"></a></div> <div class="footer__options"> <ul> <li><a href="/conduct">Conduct</a></li> <li><a href="/maintenance">Maintenance</a></li> <li><a href="/security">Security</a></li> <li><a href="/trademarks">Trademarks</a></li> <li><a href="https://opensource.org/licenses/MIT">License</a></li> </ul> </div> </footer> </body> </html>

CINXE.COM

Ruby on Rails — A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern.