Skip to content

This project prime goal is to bind the google's Material Components project to Seaside and as second goal to build widgets on top of Material Components to help Seaside developers to create web applications with material design faster.

License

Notifications You must be signed in to change notification settings

DuneSt/MaterialComponents

Repository files navigation

MaterialComponents for Seaside

Master Build Status| Development Build Status

Coverage:

Coverage Status

THIS PROJECT IS A WIP

This project has as first goal to bind the Google's Material Components Web project to Seaside and as second goal to build widgets on top of Material Design to help Seaside developers in creating fast web application with flat design. For a tutorial on Seaside check http://book.seaside.st.

Documentation

Version management

This project use semantic versioning to define the releases. This means that each stable release of the project will be assigned a version number of the form vX.Y.Z.

  • X defines the major version number
  • Y defines the minor version number
  • Z defines the patch version number

When a release contains only bug fixes, the patch number increases. When the release contains new features that are backward compatible, the minor version increases. When the release contains breaking changes, the major version increases.

Thus, it should be safe to depend on a fixed major version and moving minor version of this project.

Installation

To install MaterialComponents on your Pharo image, execute the following script:

    Metacello new
    	githubUser: 'DuneSt' project: 'MaterialComponents' commitish: 'master' path: 'src';
    	baseline: 'MaterialComponents';
    	onWarningLog;
    	load

To add MaterialComponents Seaside to your baseline just add this:

    spec
    	baseline: 'MaterialComponents'
    	with: [ spec repository: 'github://DuneSt/MaterialComponents:master/src' ]

Note you can replace the #master by another branch such as #development or a tag such as #v1.0.0, #v1.? or #v1.2.? .

Getting started

TODO

Examples

You can find multiple examples when the application will be installed at the url: http://localhost:8080/mdc

When you install in a plain Pharo image you need to start the seaside server first by opening World menu > Tools > Seaside Control Panel and adding and starting an appropropriate ZnZincServerAdaptor. If you do not use port 8080, change the port in the URL.

You can also open the demo from the menu bar under MaterialComponents.

You can find a demo at: https://mdc.ferlicot.fr/

Latest supported Dependencies

Smalltalk versions compatibility

MDL version Compatible Pharo versions Compatible Gemstone versions
Dev Pharo 61, 70, 80 None

Under the hood

Understanding what is going on under the hood is always useful. Have a look at https://material.io/develop/web/.

Contact

If you have any questions or problems do not hesitate to open an issue or contact cyril (a) ferlicot.me

About

This project prime goal is to bind the google's Material Components project to Seaside and as second goal to build widgets on top of Material Components to help Seaside developers to create web applications with material design faster.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published