<!--
SPDX-FileCopyrightText: 2023 Dyne.org foundation
SPDX-FileCopyrightText: 2023 Puria Nafisi Azizi <puria@dyne.org>

SPDX-License-Identifier: AGPL-3.0-or-later
-->

<h1 align="center">
  <a href="https://dyne.org/components">
    Dyne components
  </a>
  <br>
  <sub>Make your HTML a Dyner place</sub>
</h1>

<br><br>

<h4 align="center">
  <a href="#-quick-start">🎮 Quick start</a>
  <span> • </span>
  <a href="#-acknowledgements">😍 Acknowledgements</a>
  <span> • </span>
  <a href="#-contributing">👤 Contributing</a>
  <span> • </span>
  <a href="#-license">💼 License</a>
</h4>

This software is meant for the Dyne.org hackers that want to easily implement web pages and follow the new design rules of Dyne.org.

## 🎮 Quick start

### To use it add to your html page the following:

```html
<!doctype html>
<html>
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@dyne/components/dist/dyne-components/dyne-components.css" />
  <script type="module" src="https://cdn.jsdelivr.net/npm/@dyne/components/dist/dyne-components/dyne-components.esm.js"></script>
</head>
<body>
    <dyne-button emphasis="high">I'm useless but I love you 🥰</dyne-button>
</body>
</html>
```

for the list of components please head your browser to

### [https://dyne.org/components](https://dyne.org/components)

**[🔝 back to top](#toc)**

---

## 😍 Acknowledgements

<img alt="software by Dyne.org" src="https://files.dyne.org/software_by_dyne.png" width="150" />

Copyleft (ɔ) 2024 by [Dyne.org](https://www.dyne.org) foundation, Amsterdam

Designed, written and maintained by Puria Nafisi Azizi aka [@pna](https://twitter.com/pna).

Special thanks to:

- Thailand 🇹🇭 that hosted me during the first writing of this components and make this work more harmonious
- Tomato 🍅, Franziska von Guten and Micol Salomone for the hard creative work, the asset templates and the design rules

**[🔝 back to top](#toc)**

---

## 👤 Contributing

Please first take a look at the [Dyne.org - Contributor License Agreement](CONTRIBUTING.md) then

1.  🔀 [FORK IT](../../fork)
2.  Create your feature branch `git checkout -b feature/branch`
3.  Commit your changes `git commit -am 'Add some fooBar'`
4.  Push to the branch `git push origin feature/branch`
5.  Create a new Pull Request
6.  🙏 Thank you

**[🔝 back to top](#toc)**

---

## 💼 License

    Dyne components - Make your HTML Dynes
    Copyleft (ɔ) 2024 Dyne.org foundation, Amsterdam

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

**[🔝 back to top](#toc)**