This project contains branding assets and themes for edx.org. It is the edX implementation of the branding interface defined in @edx/brand-openedx. Note that we aim to avoid introducing any breaking changes.
Install this package one of two ways.
Versioned with npm. Including this project this way will allow you to control the version you pull into your application. This is safer, but it also means you will need to manually update it or use some automation to update it for you.
npm install --save @edx/brand@npm:@edx/brand-edx.org
Unversioned with Github. Including this project this way will pull in the latest version of it whenever a project's requirements are installed. This alleviates the need to manually pull in updates. The draw back is that if a breaking change is inadvertently introduced it is likely to gum up your pipeline or create a visual bug.
npm install --save @edx/brand@git+https://firstname.lastname@example.org/edx/brand-edx.org#master
Import assets from this package in a consuming node application:
import logo from '@edx/brand/logo.svg';
Images & Logos
import logo from '@edx/brand/logo.svg'; // Or the png version import logo from '@edx/brand/logo.png';
edX Logo with ®
import logo from '@edx/brand/logo-trademark.svg'; // Or the png version import logo from '@edx/brand/logo-trademark.png';
edX Logo in white
import logo from '@edx/brand/logo-white.svg'; // Or the png version import logo from '@edx/brand/logo-white.png';
Default fallback image for Card.ImageCap component
// the png version import cardFallbackImg from '@edx/brand/paragon/images/card-imagecap-fallback.png';
Use the theme in this package as described in the Paragon docs: https://edx.github.io/paragon/
@import "@edx/brand/paragon/fonts"; @import "@edx/brand/paragon/variables"; @import "@edx/paragon/scss/core/core"; @import "@edx/brand/paragon/overrides";
Publishing with Semantic Release
This project is published to npm with Semantic Release. When a pull request is merged to master Semantic Release reads the commit messages to determine whether to make a new patch. minor, or major release of this package. For more info see https://github.com/semantic-release/semantic-release#how-does-it-work