rails--rails/README.md

Action Text

🤸‍♂️💰📝

Installing

Assumes a Rails 5.2+ application with Active Storage and Webpacker installed.

1. Install the gem:

   # Gemfile
   gem "actiontext", github: "basecamp/actiontext", require: "action_text"
   gem "image_processing", "~> 1.2" # for Active Storage variants
   

2. Install the npm package (with a local reference to this checked out repository):

   $ yarn add file:../actiontext
   

   // app/javascript/packs/application.js
   import "actiontext"
   

3. Migrate the database

   ./bin/rails action_text:install
   ./bin/rails db:migrate
   

4. Declare text columns as Action Text attributes:

   # app/models/message.rb
   class Message < ActiveRecord::Base
     has_rich_text :content
   end
   

5. Replace form text_areas with rich_text_areas:

   <%# app/views/messages/_form.html.erb %>
   <%= form_with(model: message) do |form| %>
     …
     <div class="field">
       <%= form.label :content %>
       <%= form.rich_text_area :content %>
     </div>
     …
   <% end %>