Web Components implementing the 2017 theme.
Clone or download
kebowdog and Gi60s updated CSS to include both margin and padding for footer columns (#441)
* updated CSS to include both margin and padding for footer columns

* Updated the out of date browser message for IE
Latest commit 7131f35 Dec 12, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github GitHub templates (#372) Oct 3, 2018
components updated CSS to include both margin and padding for footer columns (#441) Dec 12, 2018
dist updated CSS to include both margin and padding for footer columns (#441) Dec 12, 2018
docs Search placeholder enhancement (#439) Dec 11, 2018
specs
.cdn-config.yml Fix font preload link in CDN config (#412) Oct 29, 2018
.gitattributes
.gitignore Add support for building with web CDN. Feb 1, 2017
LICENSE added menu demo Nov 7, 2016
README.md
every-feature.html Fix for #418 - Skinny More Menu in Firefox (#424) Nov 13, 2018
favicon.ico Added favicon and fixed line-height May 30, 2017
gulpfile.js Fixes #382 (#427) Nov 26, 2018
index.html Docs Redirect - Fixes 274 (#278) Jul 17, 2017
package-lock.json Search placeholder enhancement (#439) Dec 11, 2018
package.json Release 1.3.5 (#432) Nov 26, 2018

README.md

BYU Core Components

This repository contains the "core" Web Components implementing the BYU theme redesign begun in 2017.

Specifically, it contains the following components:

  • byu-header
  • byu-menu
  • byu-search
  • byu-user-info
  • byu-footer
  • byu-footer-column
  • byu-social-media-links
  • byu-footer-action-button

In order for a BYU website to be considered compliant with current branding standards it must make use of at least the byu-header and byu-footer components. Additionally, the byu-menu, byu-search, and byu-user-info should be used for the site's primary navigation, search, and login display, if any. The byu-footer-column and byu-footer-action-button are used to add content to the footer if desired. The byu-social-media-links component contains the approved icons for all the major social media platforms and is strongly recommended. Use of unapproved or modified social media icons may violate those platforms' copyright and is not allowed.

Important links

brand.byu.edu contains a full description of the BYU website branding guidelines

theme-dev.byu.edu contains implementation guidelines for the current BYU theme, as well as a list of optional components created by the BYU web community that can improve and simplify your website. This site is currently under construction, so please let us know if there are things you'd like on it.

web.byu.edu is the central hub for communication, events, and news relating to the BYU Web Community. It includes a calendar with upcoming events (including WebFests and user group meetings), the proceedings and latest decisions of the Web Advisory Board, and info on the various working groups creating community resources. It also has info on how to join the BYU Web Slack channels.

Getting Started:

To begin using the components you can visit the components demo site for more documentation and code samples. If you're using Drupal or Wordpress, the community has created templates that you can download and install. However, one of the primary goals and benefits of using a web components implementation is that you don't need to use a specific CMS (or any CMS at all) to utilize the components.

CDN Integration

This repository is integrated with the BYU Web Content Delivery Network (cdn) at cdn.byu.edu. This means that every update to the master branch of the repository will be pushed immediately to the cdn, allowing websites across campus to receive the latest updates immediately. More documentation can be found on the CDN Project Page.

Release Process and Timelines

A new version of these components will be released monthly unless there are no new issues to address. These monthly releases will be either bug-fix releases or minor releases that introduce new features. In addition, if a major bug is discovered we may make an unscheduled release to address it. Releases will use semver standards. Minor and bug-fix releases will maintain backwards compatibility, while major releases could potentially include breaking changes. If a major release is proposed and accepted we will ensure that the BYU web community is given ample time to prepare for any breaking changes and migrate their code accordingly.

How to contribute:

This project is open to the community and we welcome contributions. You can start by forking this repo and submitting a pull request, though we strongly recommend you also join the slack channel at byu-web.slack.com so you can be part of the discussion.

Our coding standards

Our goal is to implement flexible, well-structured web components according to the latest brand guidelines. Every pull request must be peer-reviewed by one of the project administrators before it can be merged with the master branch. As of this writing we require that any components work properly in at least the 2 latest versions of the following browsers:

  • Chrome
  • Firefox
  • Safari (Desktop and iOS versions)
  • Microsoft Edge

In addition, every component must be responsive, providing a first-class experience to phone and tablet users.

Favicon

All BYU Websites are encouraged to use the official favicon. This is likely to be located on brand.byu.edu in the future, but it is available now in github: https://github.com/byuweb/byu-assets/blob/master/favicon.png.

Using Github

There's plenty of documentation online about how to work with GitHub and the Git source control system, and there are excellent Git plugins available for most IDEs. If you've never worked with Github before, GitHub has provided some good documentation at guides.github.com. You can also join the slack channel and connect with other developers from the project.