Coverage:
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.
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.
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.? .
TODO
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/
MDL version | Compatible Pharo versions | Compatible Gemstone versions |
---|---|---|
Dev | Pharo 61, 70, 80 | None |
Understanding what is going on under the hood is always useful. Have a look at https://material.io/develop/web/.
If you have any questions or problems do not hesitate to open an issue or contact cyril (a) ferlicot.me