]> git.ipfire.org Git - thirdparty/foundation/foundation-sites.git/blame - README.md
Merge tag 'v6.7.4' into develop
[thirdparty/foundation/foundation-sites.git] / README.md
CommitLineData
739b0952 1<p align="center">
51b8286b 2 <a href="http://get.foundation/">
afc13abd 3 <img src="https://user-images.githubusercontent.com/9939075/38782856-2a64a43e-40fa-11e8-89cd-e873af03b3c4.png" alt="Foundation for Sites 6" width="448px" style="max-width:100%;"/>
739b0952
NC
4 </a>
5</p>
739b0952
NC
6
7<p align="center">
51b8286b 8 <a href="https://get.foundation/sites/docs/installation.html"><b>Install</b></a>
2af269f3 9 | <a href="https://get.foundation/sites/docs/">Documentation</a>
fc5998ab 10 | <a href="https://github.com/foundation/foundation-sites/releases">Releases</a>
4ffab21f 11 | <a href="CONTRIBUTING.md">Contributing</a>
739b0952
NC
12</p>
13
14---
15
c62ae9f7 16[![Build Status](https://github.com/foundation/foundation-sites/workflows/CI/badge.svg)](https://github.com/foundation/foundation-sites/actions?workflow=CI)
fc5998ab
DR
17[![dependencies Status](https://david-dm.org/foundation/foundation-sites/status.svg)](https://david-dm.org/foundation/foundation-sites)
18[![devDependencies Status](https://david-dm.org/foundation/foundation-sites/dev-status.svg)](https://david-dm.org/foundation/foundation-sites?type=dev)
2b3d31a3
NC
19[![npm version](https://badge.fury.io/js/foundation-sites.svg)](https://badge.fury.io/js/foundation-sites)
20[![Bower version](https://badge.fury.io/bo/foundation-sites.svg)](https://badge.fury.io/bo/foundation-sites)
21[![Gem Version](https://badge.fury.io/rb/foundation-rails.svg)](https://badge.fury.io/rb/foundation-rails)
b3252acd 22[![jsDelivr Hits](https://data.jsdelivr.com/v1/package/npm/foundation-sites/badge?style=rounded)](https://www.jsdelivr.com/package/npm/foundation-sites)
cc0d22a2 23[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/zurb/foundation-sites?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
51b8286b
JW
24[![Netlify Status](https://api.netlify.com/api/v1/badges/da72b0f9-3d51-4d50-951e-6bbf5fe88601/deploy-status)](https://app.netlify.com/sites/foundation-sites/deploys)
25[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=foundation_foundation-sites&metric=alert_status)](https://sonarcloud.io/dashboard?id=foundation_foundation-sites)
26[![Known Vulnerabilities](https://snyk.io/test/github/foundation/foundation-sites/badge.svg)](https://snyk.io/test/github/foundation/foundation-sites)
27[![BrowserStack Status](https://automate.browserstack.com/badge.svg?badge_key=ZlJCVGIxaEgvaFc4TWhBZ0hFWGtIMjBRZEw0UnFrUys3ZGdrbmZ6TW5lZz0tLU9wZUdFV2lmNVd1dU9XbWxuQ05BOGc9PQ==--915d78e23eeed2ae37ce7a670bc370011a9e4fd9)](https://automate.browserstack.com/public-build/ZlJCVGIxaEgvaFc4TWhBZ0hFWGtIMjBRZEw0UnFrUys3ZGdrbmZ6TW5lZz0tLU9wZUdFV2lmNVd1dU9XbWxuQ05BOGc9PQ==--915d78e23eeed2ae37ce7a670bc370011a9e4fd9)
28
9413fe16 29
91532b74 30Foundation is the most advanced responsive front-end framework in the world. Quickly go from prototype to production, building sites or apps that work on any kind of device with Foundation. Includes a fully customizable, responsive grid, a large library of Sass mixins, commonly used JavaScript plugins, and full accessibility support.
4d83c3de 31
739b0952 32---
8db804d9 33
739b0952 34## Run locally
8abd453f 35
739b0952 36### Documentation
774be8e3 37
739b0952 38To run the documentation locally on your machine, you need [Node.js](https://nodejs.org/en/) installed on your computer. (Your Node.js version must be **6.4.0** or higher). Run these commands to set up the documentation:
888cc710 39
91532b74 40```bash
739b0952 41# Install
fc5998ab 42git clone https://github.com/foundation/foundation-sites
27de0002 43cd foundation-sites
755aadf0 44yarn
888cc710 45
739b0952 46# Start the documentation
755aadf0 47yarn start
739b0952 48```
a9cee248 49
739b0952 50### Testing
1b4bf536 51
fc5998ab 52Foundation has three kinds of tests: JavaScript, Sass, and visual regression. Refer to our [testing guide](https://github.com/foundation/foundation-sites/wiki/Testing-Guide) for more details.
1b4bf536 53
739b0952
NC
54Run tests with:
55```bash
56# Sass unit tests
755aadf0 57yarn test:sass
739b0952 58# JavaScript unit tests
755aadf0 59yarn test:javascript:units
739b0952 60# Visual tests
755aadf0 61yarn test:visual
739b0952 62```
1b4bf536 63
91532b74
GK
64## Contributing
65
51b8286b 66Check out [CONTRIBUTING.md](CONTRIBUTING.md) to see how to report an issue or submit a bug fix or a new feature, and our [contributing guide](https://get.foundation/get-involved/contribute.html) to learn how you can contribute more globally to Foundation. You can also browse the [Help Wanted](https://github.com/foundation/foundation-sites/labels/help%20wanted) tag in our issue tracker to find things to do.
c2959e52 67
5c3566d3 68## Testing powered by
69<a target="_blank" href="https://www.browserstack.com/"><img width="200" src="https://www.browserstack.com/images/layout/browserstack-logo-600x315.png"></a><br>
70[BrowserStack Open-Source Program](https://www.browserstack.com/open-source)
71
94e07789 72<!-- ## Training
739b0952 73
94e07789 74Want the guided tour to Foundation from the team that built it? The ZURB team offers comprehensive training courses for developers of all skill levels. If you're new to Foundation, check out the [Introduction to Foundation Course](http://zurb.com/university/foundation-intro?utm_source=Github%20Repo&utm_medium=website&utm_campaign=readme&utm_content=readme%20training%20link) to kickstart your skills, amplify your productivity, and get a comprehensive overview of everything Foundation has to offer. More advanced users should check out the [Advanced Foundation Course](http://zurb.com/university/advanced-foundation-training?utm_source=Github%20Repo&utm_medium=website&utm_campaign=readme&utm_content=readme%20training%20link) to learn the Advanced skills that ZURB uses to deliver quality client work in short timeframes. -->
739b0952 75
51b8286b 76Copyright © 2020 Foundation Community