commercetools-sunrise-theme

WebJar for commercetools-sunrise-theme

License

License

MIT
Categories

Categories

Github Development Tools Version Controls
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

github-com-commercetools-commercetools-sunrise-theme
Last Version

Last Version

0.58.1
Release Date

Release Date

Type

Type

jar
Description

Description

commercetools-sunrise-theme
WebJar for commercetools-sunrise-theme
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/commercetools/commercetools-sunrise-theme

Download github-com-commercetools-commercetools-sunrise-theme

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/github-com-commercetools-commercetools-sunrise-theme/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>github-com-commercetools-commercetools-sunrise-theme</artifactId>
    <version>0.58.1</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-commercetools-commercetools-sunrise-theme/
implementation 'org.webjars.npm:github-com-commercetools-commercetools-sunrise-theme:0.58.1'
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-commercetools-commercetools-sunrise-theme/
implementation ("org.webjars.npm:github-com-commercetools-commercetools-sunrise-theme:0.58.1")
'org.webjars.npm:github-com-commercetools-commercetools-sunrise-theme:jar:0.58.1'
<dependency org="org.webjars.npm" name="github-com-commercetools-commercetools-sunrise-theme" rev="0.58.1">
  <artifact name="github-com-commercetools-commercetools-sunrise-theme" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='github-com-commercetools-commercetools-sunrise-theme', version='0.58.1')
)
libraryDependencies += "org.webjars.npm" % "github-com-commercetools-commercetools-sunrise-theme" % "0.58.1"
[org.webjars.npm/github-com-commercetools-commercetools-sunrise-theme "0.58.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Commercetools Sunrise Theme

Build Status Download stability-experimental Stories in Ready

Attention

Currently the templates as well as the CSS and JavaScript files are not ready to be re-used.

Despite of that we recommend to use the project itself to develop your own theme with the current setup, as it provides useful tasks that can help you in the process. For more details, please check the Commands section.

Demo

Installation

  • Install Node.js and NPM
  • Install Sass
  • Install Grunt
  • Run npm install in the project root to install the project dependencies

How to use

You can import the theme to your project as a WebJars dependency.

All releases for this theme can be found in a Maven repository hosted by Bintray:

How to develop

Duplicate the repository and adapt package.json to create your own theme.

Set it up as explained in the Installation section, then apply your modifications as follows:

  1. Run grunt
  2. Modify the source files located in input/ folder
  3. Check your changes by accessing the desired HTML file generated in the output/ folder
  4. Once ready, enable the theme in your Sunrise project following one of the methods described in Create WebJars file

Commands

Besides grunt, which builds the whole generated site (grunt build) and watches for changes, there are other commands available. Below are listed a non-exhaustive list of them.

Notice you can always add --verbose and/or --debug to any command in order to obtain more information.

Generate HTML Site

Build the site for your theme and access the HTML files to see how it looks like.

  • grunt build to build the whole generated site

  • grunt build-images to build only images

  • grunt build-assets to build only CSS, JS and font files

  • grunt build-templates to build only i18n and HBS files, besides generating the HTML files from the Handlebars templates and the JSON data

  • grunt build-release behaves exactly as build, but additionally it fingerprints all web assets

Building the generated site also performs these tasks:

  • Compiles Sass to CSS files
  • Minifies CSS and JS files
  • Adds vendor-prefixed CSS properties with Autoprefixer
  • Compresses any PNG, JPG, GIF and SVG image file with Imagemin

Create WebJars File

Create a WebJars file from this theme and apply it to any Sunrise Java project. There are three possible ways to achieve this:

  • grunt build-webjar to create the WebJar in the root directory of the project, so that you can apply it by placing the generated JAR file in the folder for unmanaged dependencies of your Sunrise project (i.e. lib/ is the default folder for Sunrise)

  • grunt install-webjar to install the current snapshot version to your local maven repository (~/.m2/repository/com/commercetools/sunrise/commercetools-sunrise-theme) and apply it to your project as a dependency from a local environment

  • grunt release-webjar to release the current version to a remote Maven repository and move to the next development version, this way you could publicly distribute your theme and let anyone apply it to their Sunrise application as a project dependency (requires that you set up config.maven in package.json accordingly to your remote Maven repository)

Publish to GitHub Pages

Publish the generated output/ folder to GitHub Pages, so that you can easily access and share the generated HTML files of your theme, as well as all other files.

  • grunt publish to publish the generated site to GitHub Pages (requires that you set up config.github in package.json accordingly to your GitHub repository and that an environmental variable GH_TOKEN is provided containing a GitHub Access Token)

If you want to publish to GitHub Pages each time your theme changes, all you need to do is enable Travis CI for your project and define the environment variable GH_TOKEN as explained in the Travis CI Documentation.

org.webjars.npm

commercetools

commerce platform for customer-focused industry leaders

Versions

Version
0.58.1