superdesk-ui-framework

Superdesk UI Framework

Status

Documentation

Documentation page can be accessed via this link: https://ui-framework.superdesk.org/

Install and connect

To install the package via npm use

npm install --save superdesk-ui-framework

After installation, the ui-framework distributive files will be available as

import 'superdesk-ui-framework'

To use it in your angular-app you should add the module (modules)

angular.module('application', ['superdesk-ui'])

React modules

To import react modules in your application, just use

import {LineInput} from 'superdesk-ui-framework'

Contributing

• Fork repo https://github.com/superdesk/superdesk-ui-framework
• Clone git clone https://github.com/superdesk/superdesk-ui-framework
• npm install to install dependencies
• npm start to run server locally
• Files are served on localhost:9100

Creating playgrounds

• Create new your-playground.html file in examples/playgrounds
• Define new settings for your playground in examples/index.js:

.when('/playground/your-playground', {
    title: 'My Playground',
    playground: 'main', // can be publisher or react also
    template: require('../examples/playgrounds/your-playground.html')
})

• Open your playground in browser

Continuous Development

If you want to develop new components and see live changes on your project, you need to link superdesk-ui-framework with your project.

• In superdesk-ui-framework project folder run npm link
• In your project folder run npm link superdesk-ui-framework
• Start superdesk-ui-framework with npm run server command.
• All changes on superdesk-ui-framework project are now automatically updated in your project

Testing

Runing e2e&unit tests

npm run lint