README.md
92 lines
| 1 | <p align="center"> |
| 2 | <a href="https://materializecss.github.io/materialize/"> |
| 3 | <img src="https://materializecss.github.io/materialize/res/materialize.svg" width="150"> |
| 4 | </a> |
| 5 | </p> |
| 6 | |
| 7 | <h3 align="center">MaterializeCSS</h3> |
| 8 | |
| 9 | <p align="center"> |
| 10 | Materialize, a CSS Framework based on material design. |
| 11 | <br> |
| 12 | <a href="https://materializecss.github.io/materialize/"><strong>-- Browse the docs --</strong></a> |
| 13 | <br> |
| 14 | <br> |
| 15 | <a href="https://github.com/materializecss/materialize/actions/"> |
| 16 | <img src="https://github.com/materializecss/materialize/actions/workflows/nightly.yml/badge.svg" alt="GitHub Actions badge"> |
| 17 | </a> |
| 18 | <a href="https://www.npmjs.com/package/@materializecss/materialize"> |
| 19 | <img src="https://badge.fury.io/js/%40materializecss%2Fmaterialize.svg" alt="npm version badge"> |
| 20 | </a> |
| 21 | <a href="https://www.jsdelivr.com/package/npm/@materializecss/materialize"> |
| 22 | <img src="https://data.jsdelivr.com/v1/package/npm/@materializecss/materialize/badge" alt="jsDelivr version badge"> |
| 23 | </a> |
| 24 | <a href="https://gitter.im/materializecss/materialize"> |
| 25 | <img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter badge"> |
| 26 | </a> |
| 27 | </p> |
| 28 | |
| 29 | ## Table of Contents |
| 30 | - [](#quickstartQuickstart](#quickstart](#quickstart) |
| 31 | - [](#documentationDocumentation](#documentation](#documentation) |
| 32 | - [](#buildBuild](#build](#build) |
| 33 | - [](#supported-browsersSupported Browsers](#supported-browsers](#supported-browsers) |
| 34 | - [](#changelogChangelog](#changelog](#changelog) |
| 35 | - [](#testingTesting](#testing](#testing) |
| 36 | - [](#contributingContributing](#contributing](#contributing) |
| 37 | - [](#copyright-and-licenseCopyright and license](#copyright-and-license](#copyright-and-license) |
| 38 | |
| 39 | ## Quickstart: |
| 40 | Read the [](https://materializecss.github.io/materialize/getting-started.htmlgetting started guide](https://materializecss.github.io/materialize/getting-started.html](https://materializecss.github.io/materialize/getting-started.html) for more information on how to use materialize. |
| 41 | |
| 42 | - [](https://github.com/materializecss/materialize/releases/latestDownload the latest release](https://github.com/materializecss/materialize/releases/latest](https://github.com/materializecss/materialize/releases/latest) of materialize directly from GitHub. ([](https://github.com/materializecss/materialize/releases/Beta](https://github.com/materializecss/materialize/releases/](https://github.com/materializecss/materialize/releases/)) |
| 43 | - Clone the repo: `git clone https://github.com/materializecss/materialize.git` |
| 44 | - Include the files via [](https://www.jsdelivr.com/package/npm/@materializecss/materializejsDelivr](https://www.jsdelivr.com/package/npm/@materializecss/materialize](https://www.jsdelivr.com/package/npm/@materializecss/materialize). |
| 45 | - Install with [](https://www.npmjs.comnpm](https://www.npmjs.com](https://www.npmjs.com): `npm install @materializecss/materialize` (Beta: `npm install @materializecss/materialize@next`) |
| 46 | |
| 47 | ## Documentation |
| 48 | The documentation can be found at <https://materializecss.github.io/materialize>. To run the documentation locally on your machine, you need [](https://nodejs.org/en/Node.js](https://nodejs.org/en/](https://nodejs.org/en/) installed on your computer. |
| 49 | |
| 50 | ### Running documentation locally |
| 51 | Run these commands to set up the documentation: |
| 52 | |
| 53 | ```bash |
| 54 | git clone https://github.com/materializecss/materialize |
| 55 | cd materialize |
| 56 | npm install |
| 57 | ``` |
| 58 | |
| 59 | Then run `npm run dev` to compile the documentation. When it finishes, open a new browser window and navigate to `localhost:8000/docs`. We use [](https://www.browsersync.io/BrowserSync](https://www.browsersync.io/](https://www.browsersync.io/) to display the documentation. |
| 60 | |
| 61 | ### Documentation for previous releases |
| 62 | Previous releases and their documentation are available for [](https://github.com/materializecss/materialize/releasesdownload](https://github.com/materializecss/materialize/releases](https://github.com/materializecss/materialize/releases). |
| 63 | |
| 64 | ## Build |
| 65 | If you want to build `materialize.css` or `materialize.js` from the latest commit, you can build the files with the following command after `npm install`. See `package.json` to check the current version like `1.0.0`. |
| 66 | |
| 67 | ```sh |
| 68 | npm run release -- --oldver=<current_version> --newver=<new_version> |
| 69 | ``` |
| 70 | |
| 71 | ## Supported Browsers: |
| 72 | Materialize is compatible with: |
| 73 | |
| 74 | - Chrome 35+ |
| 75 | - Firefox 31+ |
| 76 | - Safari 9+ |
| 77 | - Opera |
| 78 | - Edge |
| 79 | - IE 11+ |
| 80 | |
| 81 | ## Changelog |
| 82 | For changelogs, check out [](https://github.com/materializecss/materialize/releasesthe Releases section of materialize](https://github.com/materializecss/materialize/releases](https://github.com/materializecss/materialize/releases) or the [](CHANGELOG.mdCHANGELOG.md](CHANGELOG.md](CHANGELOG.md). |
| 83 | |
| 84 | ## Testing |
| 85 | We use Jasmine as our testing framework and we're trying to write a robust test suite for our components. If you want to help, [](CONTRIBUTING.md#jasmine-testing-guidehere's a starting guide on how to write tests in Jasmine](CONTRIBUTING.md#jasmine-testing-guide](CONTRIBUTING.md#jasmine-testing-guide). |
| 86 | |
| 87 | ## Contributing |
| 88 | Check out the [](CONTRIBUTING.mdCONTRIBUTING document](CONTRIBUTING.md](CONTRIBUTING.md) in the root of the repository to learn how you can contribute. You can also browse the [](https://github.com/materializecss/materialize/labels/help-wantedhelp-wanted](https://github.com/materializecss/materialize/labels/help-wanted](https://github.com/materializecss/materialize/labels/help-wanted) tag in our issue tracker to find things to do. |
| 89 | |
| 90 | ## Copyright and license |
| 91 | Code Copyright 2023 Materialize. Code released under the MIT license. |
| 92 |