Catalyst Islandora base theme

Setup

Install base theme to your project

Open composer.json in your project root, add following repository in repositories array

"repositories": [
    ...
    {
        "type": "vcs",
        "url": "https://github.com/catalyst/cca_base.git"
    },
    ...
]

Create subtheme

Go to themes/contrib/cca_base/subtheme
Make script executable
```
chmod +x scripts/create_subtheme.sh
```
Run script. You will be asked to enter the subtheme name. The subtheme will be created under themes/custom/{subtheme_name}.
```
./scripts/create_subtheme.sh
```

Enable subtheme

Once you have finished creating your subtheme, enable it in /admin/appearance.

Updating base theme

To update, run composer require islandora/cca_base. This will update if there is a new tag. Note that composer update somehow doesn't get the new version. Use composer require.

Theming

Setup dev env

This will install the tooling for compiling scss.

Go to themes/custom/your_theme
Run npm install
Install gulp if not already: npm install --global gulp-cli

Basic theming

Replace favicon.ico and logo.svg
Define colours and other bootstrap variables that you want to override in scss/_variables.scss
Define typography in scss/_typography.scss
Additional stylings go to scss/style.scss (or split files if necessary)
Compile scss to css (see below)
Add custom templates in templates folder
Don't forget to drush cr

Gulp commands for compiling css

`gulp styles`

Compiles scss to css.

`gulp styles:watch`

Compiles scss to css, then watchs for scss changes and recompiles automatically.

kayakr / cca_base