Skip to content
No description, website, or topics provided.
HTML CSS JavaScript PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Updated block/component review git issue template Oct 17, 2019
app/config Updating to version 0.16.7 Jan 14, 2020
dist Updating to version 0.16.7 Jan 14, 2020
docs Updating prod docs to version 0.16.7 Jan 14, 2020
src Updating to version 0.16.7 Jan 14, 2020
.babelrc Initial setup to switching over to webpack Oct 7, 2019
.browserslistrc Initial setup to switching over to webpack Oct 7, 2019
.env-example Finished updating webpack files to do a more accurate buidl for dev/p… Nov 21, 2019
.gitignore
.jshintrc Initial setup to switching over to webpack Oct 7, 2019
.postcssrc.js
.prettierignore
.stylelint Stylelint fixes. Sep 5, 2019
CHANGELOG.md Updating to version 0.15.7 Jan 6, 2020
CODE_OF_CONDUCT.md Fixed typo in code of conduct Jan 14, 2019
LICENSE
README.md Updated readme to include missing setup step, and added information o… Dec 30, 2019
RELEASE.md Updating to version 0.15.5 Dec 30, 2019
component-manager.php Refactored for v1. Jan 14, 2019
composer.json
package.json Updating to version 0.16.7 Jan 14, 2020
webpack.build.js Finished updating webpack files to do a more accurate buidl for dev/p… Nov 21, 2019
webpack.dev.js
webpack.mix.js Commented out mqpacker for both instances of where mix runs Oct 3, 2019
webpack.prod.js
webpack.release.js

README.md

Raven Design System (RDS)

RDS, Carleton University’s design system, is a living digital organism uniting campus wide teams around a common visual language.

Let my heart be still a moment and this mystery explore...

Getting started

Note: instructions below are for working with the RDS Docs package. RDS design systems documentation can be found at https://ravendesignsystem.github.io/rds/

Clone repo

Clone this repo https://github.com/ravendesignsystem/rds.git into your project directory.

Install Dependencies

Make sure you have composer, node and npm installed.

Check if they are installed and what version is installed. If either is not installed, use the links below to learn how.

  • composer --version -- Read more about Composer
  • node --version -- Read more about Node.js
  • npm --version -- NPM is install as a part of Node.js

Install packages

Once the dependencies above are installed, run the commands below to install the required packages.

  • npm install -- installs all the dependencies set in the package.json file
  • composer install -- installs all the dependencies set in the composer.json file
  • cp ./.env-example ./.env - creates a local env file

Note: items in the .env file require manual changes, these are only available to a member of Carleton Web Services.

The above commands assume you have composer installed globally. If you have composer install at the project level, you would need to run php composer.phar.

Running RDS Locally for dev

The above command runs both the sculpin static site generator, read more and the webpack watch task, read more concurrently.

  • npm run dev

In order to fully stop the watch task and sculpin server, you need to do more than stop webpack. Once that is stopped, to the following:

  • sudo lsof -i tcp:8000 - get the PID of the sculpin task and make note of it
  • kill -9 PID - replace PID with the number from the step above

Deployment

To deploy, terminate both the watch task as well as the sculpin services, and follow the steps outlined in the Release Doc

Full docs

Further documentation on how to build the RDS docs is available in the wiki.

Break down into end to end tests

TODO

Technologies

RDS and its documentation are built with:

Contributing

  • TODO

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

  • TODO

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • Hat tip to anyone who's code was used.
  • We've stood on the backs of giants for sure.
  • Inspiration
  • TODO
You can’t perform that action at this time.