Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Familiarity with these technologies (or even just CSS + HTML) is all you need to do basic theming of the DSpace UI.

Running the UI in Developer Mode

Whenever you are making changes in the User Interface, you'll want to run the User Interface locally in developer mode by running:

Code Block
yarn start:dev

This mode has several development-specific advantages:

  • UI starts more rapidly
  • UI will use a separate "environment.dev.ts" configuration file. This lets you have development specific configs, separate from your "environment.prod.ts" or the default "environment.common.ts"
  • UI will automatically reload anytime you modify a file.  Essentially the UI will constantly "watch" for changes (as you make them) & will reload anytime you modify a file.  This lets you find issues/bugs more rapidly and also test more rapidly.

Keep in mind, you should NEVER run the UI in developer mode in production scenarios.  Production mode (yarn start) provides much better performance and ensures your site fully supports SEO, etc.

Creating a Custom Theme

Theme Directories & Design Principles

...