Reuse IMASUS
Open source
The reusable IMASUS product is the Rails application: a starting point for running collaborative workshops, projects, learning resources, and an imagineering-based educational programme.
Start with the application
The software to fork and adapt is IMASUS App, the Rails application behind the workshop experience. This public archive is a read-only companion site: it preserves completed public work, but it is not the application to use when building a new programme.
IMASUS App is designed for educators, facilitators, and organisations working with collaborative learning around complex challenges. Use it as a foundation, then adapt its content, workflows, and visual identity to your own programme.
Set up a local development environment
The app uses Ruby 3.4, Rails 8.1, PostgreSQL, Hotwire, and Tailwind CSS. You will need a current Ruby toolchain and a local PostgreSQL service before you start.
git clone https://github.com/Munkun-Estudio/imasus-app.git my-imasus-app
cd my-imasus-app
bundle install
bin/setup
bin/rails db:prepare
bin/dev
bin/dev starts the development processes. The Rails health check is available
at /up; use it to confirm a deployment can reach the application.
Adapt it to your programme
Start by defining what your participants will do: the workshops they join, the challenges they address, the material and learning resources they need, and the public work they may choose to publish. Then adapt the application copy, translations, branding, and permissions around those decisions.
The project is built with Rails conventions, so application behavior lives in
models, controllers, views, database migrations, and tests. Keep changes small
and covered by the test suite. The repository’s own AGENTS.md, active Munkit
specifications, and contribution guidance describe the current development
workflow.
Configure production services
A production deployment needs more than the Rails code: provision PostgreSQL, configure the application’s environment variables and secrets, and choose storage for uploaded media. IMASUS uses Active Storage with an S3-compatible service for production media; use a bucket and access policy you control.
The repository includes a Dockerfile and Kamal configuration, but you can deploy the app to any environment that runs Rails, PostgreSQL, and its background services. Before inviting participants, test sign-in, permissions, uploads, email delivery, queues, and backups in a non-production environment.
Rights, privacy, and attribution
Review the license and notices in the application repository before distributing your derivative. Code terms do not automatically license participant work, workshop materials, partner logos, photographs, video, or third-party content.
Before publishing a public archive, confirm permission, attribution, and privacy for every item it includes. Read this archive’s content rights notice before reusing IMASUS content itself.