Build Status

Spud Core Admin

Spud Admin is a dependency package that adds a nice looking administrative panel to any project you add it to with built in authlogic authentication ready to go out of the box. It supports easy engine integration and there are several planned future engines that we plan on designing for the spud suite. The first of which is Spud CMS which can be found at


  1. In your Gemfile add the following

    gem 'spud_core'
  2. Run bundle install

  3. Copy in database migrations to your new rails project

    bundle exec rake spud_core:install:migrations
    rake db:migrate
  4. run a rails server instance and point your browser to /spud/admin

Adding Your Own Engines

Creating a rails engine that ties into spud admin is fairly straight forward In your new engine add spud_admin as a dependency and create an initializer inside your engine class as such:

    initializer :admin do
        Spud::Core.configure do |config|
        config.admin_applications += [{:name => "Pages",:thumbnail => "spud/admin/pages_thumb.png",:url => "/spud/admin/pages",:order => 0}]


You can use the layouts provided with spud admin by using 'spud/admin/application' or 'spud/admin/detail' layouts

When creating controllers for the admin panel create them in the Spud::Admin Namespace and have them extend Spud::Admin::ApplicationController for automatic user authentication restrictions.


Spud uses RSpec for testing. Get the tests running with a few short commands:

  1. Create and migrate the databases:

    rake db:create
    rake db:migrate
  2. Load the schema in to the test database:

    rake app:db:test:prepare
  3. Run the tests with RSpec

    rspec spec

After the tests have completed the current code coverage stats is available by opening /coverage/index.html in a browser.

NOTE: Spud Core is Retina Resolution Compatible Now


This software is licensed under the Reciprocal 1.5 License