Skip to content
This repository has been archived by the owner on Mar 4, 2020. It is now read-only.

WARNING: This repository is no longer maintained

License

Notifications You must be signed in to change notification settings

ibm-developer/generator-ibm-web

Repository files navigation

WARNING: This repository is no longer maintained ⚠️

The functionality of this generator is now available in our MEAN and MERN static applications.

This repository will not be updated. The repository will be kept available in read-only mode.

IBM Web Generator

IBM Cloud powered Travis Coveralls Codacy Version DownloadsMonthly DownloadsTotal License Conventional Commits

Getting Started with a generated project

  1. Run the generator and choose the options: yo ibm-web

  2. Select a web framework: None, Angular or React

  3. Select a language: Swift, Node, Java, Go, Python-Flask or Python-Django

Frameworks

Frameworks are chosen using the framework option at the end of the generator. For example,

yo ibm-web --framework {None, React, AngularJS}

Basic

In the basic web project, the following files are created and stored in the public directory:

  • public/index.html - Basic landing page with inline CSS and encoded image assets
  • public/404.html - Basic 404 error page
  • public/500.html - Basic 500 error page

It is important that the web server is registered to serve files in the public directory.

React

  • react - to build user interfaces
  • webpack - bundles your JS modules
    • sass-loader
    • css-loader
    • style-loader

Web sources for React projects are stored in the client directory:

  • client/index.html - Landing page source
  • client/index.jsx - Landing page source
  • client/app/App.jsx - Component injected into landing page body
  • client/404.html and client/500.html - Error page sources
  • client/default.css - minimized stylesheet with inline encoded images

AngularJS

Web sources for AngularJS projects are stored in the client directory:

  • client/index.html - Landing page source
  • client/component.html - Landing page source
  • client/app.js - Angular app initialization, config and routing
  • client/404.html and client/500.html - Error page sources
  • client/default.css - minimized stylesheet with inline encoded images

Publishing Changes

In order to publish changes, you will need to fork the repository or branch off the master branch.

Make sure to follow the conventional commit specification before contributing. To help you with commit a commit template is provide. Run config.sh to initialize the commit template to your .git/config or use commitizen

Once you are finished with your changes, run npm test to make sure all tests pass.

Do a pull request against master, make sure the build passes. A team member will review and merge your pull request. Once merged to master an auto generated pull request will be created against master to update the changelog. Make sure that the CHANGELOG.md and the package.json is correct before merging the pull request. After the auto generated pull request has been merged to master the version will be bumped and published to npm.