Pre-built Netzke widgets for your RIA
Ruby JavaScript Shell
Clone or download
Pull request Compare This branch is 26 commits ahead, 748 commits behind netzke:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Netzke Basepack

A pack of pre-built Netzke components - such as grid, form, tab panel, etc.


  • Ruby 1.9.2
  • Rails ~> 3.1.0
  • Ext JS ~> 4.1.x


In your Gemfile:

gem 'netzke-basepack'

For the "edge" stuff, tell bundler to get the gem straight from GitHub:

gem 'netzke-basepack', :git => "git://"


Embed a basepack component into a view as any other Netzke component, e.g.:

<%= netzke :books, :class_name => 'Netzke::Basepack::GridPanel', :model => 'Book' %>

For more examples, see, and look into test/basepack_test_app.

Testing and playing with Netzke Basepack

Netzke Basepack is bundled with Cucumber and RSpec tests. If you would like to contribute to the project, you may want to learn how to run the tests.

Besides, the bundled test application is a convenient playground for those who search to experiment with the framework.

After starting up the test app, you can see the list of functional test components on the index page (along with links to the source code):


Note on testing with DataMapper/Sequel Support

To install the test app with DataMapper or Sequel, put ORM=dm or ORM=sq into your environment. For example to set-up DataMapper support run

# in test/basepack_test_app
ORM=dm bundle install

To run the test app in DataMapper-Mode (will use DataMapper models instead of ActiveRecord models)

# in test/basepack_test_app
ORM=dm rails s

To run the test suite

# in test/basepack_test_app
ORM=dm bundle exec rake


NOTE: netzke-basepack is not dependant on neither DataMapper nor Sequel. It will pick the right DataAdapter for your models automatically. ActiveRecord is still included in Gemfile of the test app, as netzke-persistance is used which uses ActiveRecord. If you don't use netzke-persistence, then you don't need to include ActiveRecord.

DataMapper support

DataMapper support is incomplete, as I didn't find a good way to sort by an association's column when the association needs a LEFT OUTER JOIN (i.e. nullable foreign key in many_to_one).

Sequel support


  • you can't use polymorphic associations for the time being, as the sequel_polymorphic plugin is not supported by netzke-basepack
  • SearchPanel is broken atm. When it's fixed, Sequel support for SearchPanel triggered queries should be implemented.

Icons support

Netzke Basepack can make use of FamFamFam Silk icon set ( To enable this, download the icons and put the "icons" folder into your app's public/images folder. Then restart your application.

Ext 3 support

Versions 0.6.x are for you if you're using Ext 3 (hardly maintained)

Rails 2 support

With Rails 2 (and Ext 3 only), use versions 0.5.x (not maintained)

More info

Official project site:


Many (if a bit outdated) tutorials:

Copyright (c) 2008-2011 NomadCoder, released under the MIT license Note, that Ext JS itself is licensed differently