Skip to content

A browser to display custom libraries and controls for display on the UI5Lab homepage and testing during development

License

Notifications You must be signed in to change notification settings

avh-sap/UI5Lab-browser

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UI5Lab Logo

What is it

UI5Lab is a community driven repository for UI5 Custom Control Libraries. It's purpose is to make it easy for everyone to share, retrieve and use UI5 Custom Controls. Contributions welcome!

UI5Lab-browser

This repository contains a browser to display custom libraries and control examples on the UI5Lab homepage. The app implemented in UI5 can also be used for testing control samples and previewing libraries during development. Have a look at our documentation for more details.

Setup

Run the following commands to test or develop this project:

  1. Install node.js (get it from nodejs.org).

Note: If working behind a proxy, you need to configure it properly (HTTP_PROXY / HTTPS_PROXY / NO_PROXY environment variables)

  1. Clone the repository and navigate into it
git clone https://github.com/UI5Lab/UI5Lab-browser
cd UI5Lab-browser
  1. Install all npm dependencies (also installs all bower dependencies)
npm install
  1. Run npm start to a local server (have a look into Gruntfile.js to see all the tasks).
npm start
  1. Open the browser with the following URL: http://localhost:8080/test-resources/ui5lab/browser/index.html

Note: To test the browser, one or more libraries should be defined as a dependency and registered in the libraries.json file. See the UI5Lab-central project for more details

Publishing the to npm

The library project and the central project reference the browser via npm module. In order to publish a new version to npm follow these steps:

  1. Maintain the package.json file and increase the version number

  2. Run grunt build to create a library preload and the CSS theme build for your library artifacts. Everything (minified and unminified sources) will be created in the dist folder, ready to be published and consumed by other projects

grunt build
  1. Publish your package to npm, be sure to include only the metadata and the dist folder to keep the package size small (see .npmignore file for details)
npm publish

Note: Official UI5Lab packages have to be published with the user ui5lab, if you do not have permission ask a member the UI5Lab core team

Directions

  • Homepage - the single point of entry for UI5Lab
  • Documentation - project overview and tutorials
  • Browser - all UI5Lab libraries and examples
  • Demo - an example app consuming simple UI5Lab controls

Troubleshooting

Issues can be created either in this repository or in any of the contributor repositories depending on where the error came from. Be sure to include enough details and context to reproduce the issue and follow up with you.

Contact

We organize this project in Slack Channel #UI5Lab. If you are interested in what we do and discuss, join with this invitation link or visit the homepage https://ui5lab.io.

The UI5Lab Community

About

A browser to display custom libraries and controls for display on the UI5Lab homepage and testing during development

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 98.0%
  • HTML 2.0%