SMaterial is made to follow the Material Design guidelines as close as possible. SMaterial should be easy to use for both developers as the customers they serve.
Being easy for developers means that SMaterial comes bundled with everyday technologies that speed up a developers workflow. SMaterial doesn't only come with everyday technologies but it also provides way to make integration easier. This for example means use a language like json that can be used with various other languages like PHP.
In order to contribute you need to have installed a couple programs. The programs used to create SMaterial are the following: Git, SASS, Webpack. Want to know how to install those programs I would advise you to visit the corresponding website.
To get up and running you need to fork this repository to your own git.
After downloading your newly created repository run
npm install in your console / terminal.
This will install files listed in
After all files have installed you can run a few commands in your console / terminal. These commands are
npm run dev for development or
npm run prod for production.
This command will compress JS and SCSS files.
The website uses PHP files to make working with the menu, headers and footers a lot easier.
To use PHP files you'll need to have a localhost or other server. I would advice to use a localhost (PHP build in server, wamp, xamp or usbwebserver) since this isn't online and therefor private to you only.
After that all you need to do is change
define( 'TEST', false ); to
define( 'TEST', true );. You can find this in
includes/header.php. This makes sure that some files aren't loaded for example Google Analytics.
Creating a pull request
After making your changes please describe what you have changed. This will speed up the process of merging your PR.
- Bottom navigation
- Bottom sheet
- Snackbars & toasts
- Fix mobile styling (in Chrome for Android when scrolling a page the title bar remains visible)
- Fix max-height max-width to something which works automatically. This applies to several components where these properties are animated
- Add Material Design animations
- Fix positions of
<aside>to be more compatible with for example WordPress (
<main>slides up under
- Add broader support for IE and FireFox
- Add SMaterial CDN package
- Add templates
- Add react and or vue
- Add badges
- Add search slide out
- Bottom navigation
- Bottom sheet
- Add toggle button actions
- Add card templates
- Data tables
- Fix styling
- Add table title
- Expansion panels
- Grid lists
- Redo styling
- Fix bug where menu is behind tabs in appbar
- Fix buffer animation
- Add radials for mobile
- Less options in settings file. Only important options. All other "options" only in the same file
- Make variables consistent. Give variables a clearer name of what they do
- Add css variables where possible. Also add fallback.
- Navigation drawer
- Add persistent mini
- Add radials
- Colors should be rgba but creates weird behaviour (like showing track trough thumb)
- Fix click bug at end of
- slider-discrete bubble not working mobile
- Add support for scroll on desktop
- Text fields
- Add autocomplete select
- Add autocomplete input
- Add slide out search
- Add dropdown search
- Create separate file for list styling
- Fix wobble on header expand rotation
- Prism.js (not part of SMaterial only used to display code in documentation)