In order to start developing you will need what is called a
development_app. This is nearly the same as a new Decidim
app (that you can create with
decidim app_name) but with a Gemfile pre-configured for local development and some other small config modifications.
We recommend that you first have a working Decidim app so that you have fullfilled all the necessary system and services requirements, like having a working Ruby installation, PostgreSQL, Node.JS, etc.
You’ll need to configure the PostgreSQL database before anything. For this,
Configure postgresql with a super-user. For instance, for a user called
changeme, it’d be:
sudo -u postgres psql -c "CREATE USER decidim_development_app_user WITH SUPERUSER CREATEDB NOCREATEROLE PASSWORD 'changeme'"
Save the database configuration in your environment variables configuration. If you’ve followed the Decidim installation manual, then you should have a working rbenv-vars in your environment:
echo "DATABASE_USERNAME=decidim_development_app_user" >> ~/.rbenv-vars echo "DATABASE_PASSWORD=changeme" >> ~/.rbenv-vars
Of course you should change the password before anything.
Then you can create a
development_appfrom inside the project’s root folder with the command:
git clone https://github.com/decidim/decidim.git cd decidim bundle install bin/rake development_app
A development_app/ entry appears in the .gitignore file, so you don’t have to worry about committing the development app by mistake.
On creation, these steps are automatically invoked by the generator:
Mind that if everything went well you shouldn’t need to run these commands manually.
If the default database.yml does not suit your needs you can always configure it at your will and run these steps manually, although we recommend that you make the database configurations with environment variables (ENV VARs) so it’s easy for you to regenerate the database.
The last command will set your database and add some example data (called "seed data") so that you can start trying Decidim. We don’t recommend using seed data for production environments, but it’s useful for local development and staging environments.
Once the app is created you are ready to start the server:
When creating new migrations in Decidim’s modules, you will need to "apply" this migrations to your development_app. The way to do this is by copying the migration from your module into the db/migrate dir of your development_app. Luckily we already have a script that automates this: it copies all missing migrations in development_app/db/migrate. The command is:
Anyway we recommend re-creating your development_app every once in a while.
Updating from develop
We recommend that you periodically update your codebase with the last changes from the main repository. For this, you’ll need to follow these instructions:
git pull origin develop bin/rails decidim:upgrade bin/rails db:migrate
And restart your rails server (with Ctrl+C to stop it).