OpenMass - a constituent focused web platform.
The following is just one way to install OpenMass. Customize to taste.
- Get the latest code, database, and uploaded files tarball from https://github.com/massgov/openmass/releases
- You may find it convenient to create an "artifacts" directory in your project root to store the database dump and uploaded files tarball. Files in this directory will be ignored by Git.
composer install. Your codebase is now assembled.
- Configure web/sites/default/settings.php for your database. Add a hash_salt value.
- Import the database
../vendor/bin/drush sql-query --file=../artifacts/dump.sql.gz
- Unzip uploaded_files.tar.gz into web/sites/default/files
- Start a development web server
- To get a URL for logging in as a superuser
../vendor/bin/drush uli --uri=http://127.0.0.1:8888
Customizing Look and Feel
One innovative feature of this platform is its use of a Pattern Lab style guide to theme most pages. Our Pattern Lab implementation, Mayflower, is a uniform look and feel for all web properties that serve Massachusetts.
- Fork the mayflower-artifacts repo
- Edit to taste. See the assets directory for CSS files.
- Edit composer.json to point to your fork
- Fork the mayflower repo.
- Edit to taste. This file is for customizing colors.
- Build a new Pattern lab style guide (
gulp) and save its output into a new "artifacts repo". Your artifacts repo should be laid out exactly like mayflower-artifacts.
- Change the mayflower-artifacts line in composer.json to point to your artifacts repository.
- One day soon, this platform will install without using a database as a seed.
- One day soon, we will have regular contributor calls to work on the platform
- Built by MassIT for the Commonwealth of Massachusetts