11.1.2 • Published 3 years ago

origami-build-tools v11.1.2

Weekly downloads
889
License
MIT
Repository
github
Last release
3 years ago

origami-build-tools

Build tools for developing Origami components.

Installation

  1. Install node.js

  2. Install the build tools globally:

    npm install -g origami-build-tools

Usage

Developing Existing Components Locally

First, change to your components directory:

git clone git@github.com:Financial-Times/o-table.git
cd o-table

Then install its dependencies:

obt install

To preview the components demos run the dev command. The dev command will automatically re-build the demos every time a file changes:

obt dev

After making your changes run the linter and check for errors:

obt lint

Also run the components tests:

obt test

To debug JavaScript test errors with immediate feedback and breakpoints, pass the debug flag. This will open the tests in a browser window with logs in the browser console. It will also watch and rebuild tests when you make changes:

obt test --debug

Further, JavaScript tests may be run in BrowserStack automatically with the --browserstack flag. See the test command for more details.

Creating A New Component

Origami Build Tools provides boilerplate for creating up a new Origami component. Run obt init and follow the prompts.

API Reference

Usage
	$ obt <command> [<options>]

Commands
	install, i             Install npm dependencies required to build the component
	develop, dev           Build demos locally every time a file changes and run a server to view them
	demo, d                Build demos into the demos directory
	init                   Initialise a new component with a boilerplate folder structure
	test, t                Run Origami specification tests and component specific tests
	verify, v, lint, l     Check folder and code structure follows Origami specification

Options
	-h, --help                 Print out this message
	-v, --version              Print out version of origami-build-tools
	--browserstack             Run tests using Browserstack instead of Chrome Stable
	--demo-filter=<demo-name>  Build a specific demo. E.G. --demo-filter=pa11y to build only the pa11y.html demo.
	--brand=<brand-name>       Build SCSS for a given brand. E.G. --brand=internal to build the component for the internal brand.
	--debug                    Keep the test runner open to enable debugging in any browser.

Commands

install or i

Install npm required to build components.

develop or dev

Build demos locally every time a file changes and run a server to view them.

init

Creates boilerplate for a new Origami component.

demo or d

Build demos found in the origami.json manifest.

Build a specific demo with the --demo-filter option.

Demos consist of HTML, CSS and JS (if Sass & JS exists), and are created in demos/local/. These files should not be committed. It is recommended to add demos/local/ to your .gitignore.

verify or v or lint or l

Lints JavaScript, Sass and configuration files (see Origami code recommendations).

test or t

Runs JavaScript and Sass tests.

  • If --debug is set, the test runner will not exit automatically to allow debugging of the tests.

Checks Sass includes a primary mixin. If pa11y.html demo exists, confirms it is accessible using Pa11y. Runs tests using Karma defaulting to Chrome Stable, can be configured to use BrowserStack by using the --browserstack flag. You will need the environment variables BROWSER_STACK_USERNAME and BROWSER_STACK_ACCESS_KEY set. This will run the tests on the minimum version for enhanced experience based on the [FT Browser Support Policy[(https://docs.google.com/document/d/1mByh6sT8zI4XRyPKqWVsC2jUfXHZvhshS5SlHErWjXU).

Migration Guides

StateMajor VersionLast Minor ReleaseMigration guide
✨ active11N/Amigrate to v11
⚠ maintained1010.9migrate to v10
╳ deprecated99.0migrate to v9
╳ deprecated88.2migrate to v8
╳ deprecated77.14migrate to v7
╳ deprecated66.2migrate to v6
╳ deprecated55.8-
╳ deprecated44.5-
╳ deprecated33.3-
╳ deprecated22.1-
╳ deprecated11.0N/A

Licence

This software is published by the Financial Times under the MIT licence.

11.1.2

3 years ago

11.0.7

3 years ago

11.1.1

3 years ago

11.1.0

3 years ago

11.0.6

3 years ago

11.0.5

3 years ago

10.9.2

3 years ago

10.9.1

3 years ago

11.0.4

3 years ago

11.0.2

3 years ago

11.0.3

3 years ago

11.0.0

3 years ago

11.0.1

3 years ago

11.0.0-beta.35

3 years ago

11.0.0-beta.34

3 years ago

11.0.0-beta.24

4 years ago

11.0.0-beta.23

4 years ago

11.0.0-beta.22

4 years ago

11.0.0-beta.28

4 years ago

11.0.0-beta.27

4 years ago

11.0.0-beta.26

4 years ago

11.0.0-beta.25

4 years ago

11.0.0-beta.29

4 years ago

11.0.0-beta.31

3 years ago

11.0.0-beta.30

4 years ago

11.0.0-beta.33

3 years ago

11.0.0-beta.32

3 years ago

11.0.0-beta.21

4 years ago

11.0.0-beta.19

4 years ago

11.0.0-beta.20

4 years ago

11.0.0-beta.17

4 years ago

11.0.0-beta.18

4 years ago

10.9.1-beta.0

4 years ago

10.9.0

4 years ago

10.8.15

4 years ago

11.0.0-beta.16

4 years ago

10.8.14

4 years ago

10.8.13

4 years ago

10.8.12

4 years ago

11.0.0-beta.15

4 years ago

11.0.0-beta.14

4 years ago

11.0.0-beta.13

4 years ago

11.0.0-beta.12

4 years ago

11.0.0-beta.11

4 years ago

11.0.0-beta.10

4 years ago

11.0.0-beta.9

4 years ago

11.0.0-beta.8

4 years ago

11.0.0-beta.6

4 years ago

11.0.0-beta.7

4 years ago

11.0.0-beta.5

4 years ago

10.8.11

4 years ago

10.8.9

4 years ago

10.8.10

4 years ago

11.0.0-beta.3

4 years ago

11.0.0-beta.4

4 years ago

11.0.0-beta.2

4 years ago

11.0.0-beta.1

4 years ago

10.8.8

4 years ago

10.8.7

4 years ago

10.8.6

4 years ago

10.8.5

4 years ago

10.8.4

4 years ago

10.8.3

4 years ago

10.8.2

4 years ago

10.8.1

4 years ago

10.8.0

4 years ago

10.7.4

4 years ago

10.7.3

4 years ago

10.7.2

4 years ago

10.7.1

4 years ago

10.7.0

4 years ago

10.6.3

4 years ago

10.6.1

4 years ago

10.6.2

4 years ago

10.6.0

4 years ago

10.5.10

4 years ago

10.5.9

4 years ago

10.5.8

4 years ago

10.5.7

4 years ago

10.5.6

4 years ago

10.5.5

4 years ago

10.5.4

4 years ago

10.5.3

4 years ago

10.5.2

4 years ago

10.5.0

4 years ago

10.5.1

4 years ago

10.4.1

4 years ago

10.4.2

4 years ago

10.4.0

4 years ago

10.3.0

4 years ago

10.2.0

4 years ago

10.1.10

4 years ago

10.1.9

4 years ago

10.1.8

5 years ago

10.1.6

5 years ago

10.1.7

5 years ago

10.1.5

5 years ago

10.1.4

5 years ago

10.0.4

5 years ago

10.1.0

5 years ago

10.1.1

5 years ago

10.1.2

5 years ago

10.1.3

5 years ago

10.0.1

5 years ago

10.0.2

5 years ago

10.0.3

5 years ago

10.0.0

5 years ago

9.0.13

5 years ago

9.0.12

5 years ago

9.0.11

5 years ago

9.0.10

5 years ago

9.0.9

5 years ago

9.0.8

5 years ago

9.0.7

5 years ago

9.0.6

5 years ago

9.0.5

5 years ago

9.0.4

5 years ago

9.0.3

5 years ago

9.0.2

5 years ago

9.0.1

5 years ago

9.0.0

5 years ago

8.2.16

5 years ago

8.2.15

5 years ago

8.2.14

5 years ago

8.2.13

5 years ago

8.2.12

5 years ago

5.8.2

5 years ago

8.2.10

5 years ago

8.2.11

5 years ago

8.2.9

5 years ago

8.2.8

5 years ago

8.2.7

5 years ago

8.2.6

5 years ago

8.2.5

5 years ago

8.2.4

5 years ago

8.2.3

5 years ago

8.2.2

5 years ago

8.2.1

5 years ago

8.2.0

5 years ago

8.1.5

5 years ago

8.1.4

5 years ago

8.1.3

5 years ago

8.1.2

5 years ago

8.1.1

5 years ago

8.1.0

5 years ago

8.0.4

6 years ago

8.0.3

6 years ago

7.14.0

6 years ago

7.13.3

6 years ago

7.13.2

6 years ago

7.13.1

6 years ago

7.13.0

6 years ago

7.12.3

6 years ago

7.12.2

6 years ago

7.12.1

6 years ago

7.12.0

6 years ago

7.11.0

6 years ago

7.10.0

6 years ago

7.9.0

6 years ago

7.8.1

6 years ago

7.8.0

6 years ago

7.7.8

6 years ago

7.7.5

6 years ago

7.7.4

6 years ago

7.7.3

6 years ago

7.7.2

7 years ago

5.8.0

7 years ago

7.7.1

7 years ago

7.7.0

7 years ago

7.6.3

7 years ago

7.6.2

7 years ago

7.6.1

7 years ago

7.6.0

7 years ago

7.5.0

7 years ago

7.4.0

7 years ago

7.3.3

7 years ago

7.3.2

7 years ago

7.3.1

7 years ago

7.3.0

7 years ago

7.2.4

7 years ago

7.2.1

7 years ago

5.7.1

7 years ago

5.7.0

7 years ago

5.6.5-0

7 years ago

7.2.0

7 years ago

7.1.0

7 years ago

0.0.0

7 years ago

7.0.3

7 years ago

7.0.2

7 years ago

7.0.1

7 years ago

7.0.0

7 years ago

7.0.0-beta.12

7 years ago

7.0.0-beta.11

7 years ago

7.0.0-beta.10

7 years ago

7.0.0-beta.9

7 years ago

7.0.0-beta.8

7 years ago

7.0.0-beta.7

7 years ago

7.0.0-beta.6

7 years ago

7.0.0-beta.5

7 years ago

7.0.0-beta.4

7 years ago

7.0.0-beta.3

7 years ago

7.0.0-beta.2

7 years ago

7.0.0-beta.1

7 years ago

5.6.4

7 years ago

6.2.5

7 years ago

5.6.3

7 years ago

6.2.4

7 years ago

5.6.2

7 years ago

6.2.3

7 years ago

5.6.1

8 years ago

6.2.2

8 years ago

6.2.1

8 years ago

5.6.0

8 years ago

6.2.0

8 years ago

6.1.0

8 years ago

6.0.1

8 years ago

6.0.0

8 years ago

5.5.5

8 years ago

5.5.4

8 years ago

5.5.3

8 years ago

5.5.2

8 years ago

5.5.1

8 years ago

5.5.0

8 years ago

5.4.0

8 years ago

5.3.0

8 years ago

5.2.0

8 years ago

5.1.3

9 years ago

5.1.2

9 years ago

5.1.1

9 years ago

5.1.0

9 years ago

5.0.1

9 years ago

5.0.0

9 years ago

4.5.3

9 years ago

5.0.0-beta.7

9 years ago

5.0.0-beta.6

9 years ago

5.0.0-beta.5

9 years ago

5.0.0-beta.4

9 years ago

5.0.0-beta.3

9 years ago

4.5.2

9 years ago

4.5.1

9 years ago

4.5.0

9 years ago

5.0.0-beta.2

9 years ago

4.4.1

9 years ago

5.0.0-beta.1

9 years ago

4.4.0

9 years ago

4.3.2

9 years ago

4.3.1

9 years ago

4.3.0

9 years ago

4.2.0

9 years ago

4.1.1

9 years ago

4.1.0

9 years ago

4.0.1

9 years ago

4.0.0

9 years ago

4.0.0-beta.7

9 years ago

3.3.5

9 years ago

3.3.4

9 years ago

4.0.0-beta.6

9 years ago

4.0.0-beta.5

9 years ago

3.3.3

9 years ago

3.3.2

9 years ago

3.3.1

9 years ago

4.0.0-beta.3

9 years ago

4.0.0-beta.2

9 years ago

4.0.0-beta.1

9 years ago

3.3.0

9 years ago

3.2.1

9 years ago

3.2.0

9 years ago

3.1.0

9 years ago

3.1.0-beta.1

9 years ago

3.0.2

9 years ago

3.0.1

9 years ago

3.0.0

9 years ago

3.0.0-beta.4

9 years ago

3.0.0-beta.3

9 years ago

3.0.0-beta.2

10 years ago

3.0.0-0

10 years ago

2.13.0

10 years ago

2.12.1

10 years ago

2.12.0

10 years ago

2.11.0

10 years ago

2.10.1

10 years ago

2.10.0

10 years ago

2.9.4

10 years ago

2.9.3

10 years ago

2.9.2

10 years ago

2.9.1

10 years ago

2.9.0

10 years ago

2.8.0

10 years ago

2.7.0

10 years ago

2.6.3

10 years ago

2.6.2

10 years ago

2.6.1

10 years ago

2.6.0

10 years ago

2.5.0

10 years ago

2.4.2

10 years ago

2.4.1

10 years ago

2.4.0

10 years ago