1
0
Fork 0
freesewing/config/templates/readme.main.md

138 lines
4.7 KiB
Markdown
Raw Normal View History

<p align='center'><a
href="https://www.npmjs.com/package/@freesewing/core"
title="@freesewing/core on NPM"
><img
src="https://img.shields.io/npm/v/@freesewing/core.svg"
alt="@freesewing/core on NPM"/>
</a> <a
href="https://opensource.org/licenses/MIT"
title="License: MIT"
><img
src="https://img.shields.io/npm/l/@freesewing/core.svg?label=License"
alt="License: MIT"/>
</a> <a
href="https://deepscan.io/dashboard#view=project&tid=2114&pid=2993&bid=23256"
title="Code quality on DeepScan"
><img
src="https://deepscan.io/api/teams/2114/projects/2993/branches/23256/badge/grade.svg"
alt="DeepScan grade"
></a> <a
href="https://codeberg.org/freesewing/freesewing/issues?q=is%3Aissue+is%3Aopen"
title="Open issues"
><img
src="https://img.shields.io/github/issues/freesewing/freesewing.svg?label=Issues"
alt="Open issues"/>
</a> <a
href="#contributors-"
title="All Contributors"
><img
src="https://img.shields.io/badge/all_contributors-{{ allcontributors }}-pink.svg"
alt="All Contributors"/>
</a></p>
<p align='center'><a
href="https://forum.freesewing.eu"
title="Join the FreeSewing Forum"
><img
src="https://img.shields.io/discourse/users?server=https%3A%2F%2Fforum.freesewing.eu&label=Forum&color=%2385d996"
alt="Join the FreeSewing Forum"
/></a> <a
href="https://discord.freesewing.org"
title="Chat with us on Discord"
><img
src="https://img.shields.io/discord/698854858052075530?label=Chat%20on%20Discord"
alt="Chat with us on Discord"
/></a> <a
href="https://freesewing.org/patrons/join"
title="Become a FreeSewing Patron"
><img
src="https://img.shields.io/badge/%F3%A0%80%A0-Support%20us-blueviolet.svg?logo=cash-app&logoColor=white&logoWidth=15"
alt="Become a FreeSewing Patron"
/></a></p>
2024-02-04 10:44:55 +01:00
# FreeSewing
2024-02-04 10:44:55 +01:00
> [!TIP]
>#### Support FreeSewing: Become a patron, or make a one-time donation 🥰
>
> FreeSewing is an open source project maintained by Joost De Cock and financially supported by the FreeSewing patrons.
>
> If you feel FreeSewing is worthwhile, and you can spend a few coins without
hardship, then you should [join us and become a patron](https://freesewing.eu/patrons/join).
2024-02-04 10:44:55 +01:00
## What am I looking at? 🤔
2024-02-04 10:44:55 +01:00
This repository is the FreeSewing *monorepo* holding all FreeSewing's websites, documentation, designs, plugins, and other NPM packages.
## About FreeSewing 💀
Where the world of makers and developers collide, that's where you'll find FreeSewing.
If you're a maker, checkout [freesewing.eu](https://freesewing.eu/) where you can generate
2023-09-30 17:40:53 +02:00
sewing patterns adapted to your measurements.
2023-09-30 17:40:53 +02:00
If you're a developer, the FreeSewing documentation lives at [freesewing.dev](https://freesewing.dev/).
The FreeSewing [core library](https://freesewing.dev/reference/api/) is a *batteries-included* toolbox
for parametric design of sewing patterns. But FreeSewing also provides a range
of [plugins](https://freesewing.dev/reference/plugins/) that further extend the
functionality of the platform.
If you have NodeJS installed, you can try it right now by running:
```bash
npx @freesewing/studio
```
2023-09-30 17:40:53 +02:00
Getting started guides are available for:
- [Linux](https://freesewing.dev/tutorials/getting-started-linux/)
- [MacOS](https://freesewing.dev/tutorials/getting-started-mac/)
- [Windows](https://freesewing.dev/tutorials/getting-started-windows/)
2023-09-30 17:40:53 +02:00
The [pattern design tutorial](https://freesewing.dev/tutorials/pattern-design/) will
show you how to create your first parametric design.
2024-02-04 10:44:55 +01:00
## Getting started ⚡
2024-02-04 10:44:55 +01:00
To get started with FreeSewing, you can spin up our development environment with:
2024-02-04 10:44:55 +01:00
```bash
npx @freesewing/studio
2024-02-04 10:44:55 +01:00
```
To work with FreeSewing's monorepo, you'll need [NodeJS v20](https://nodejs.org) and [lerna](https://lerna.js.org/) on your system.
Once you have those, clone (or fork) this repo and run `npm run kickstart`:
2024-02-04 10:44:55 +01:00
```bash
git clone git@codeberg.org:freesewing/freesewing.git
2024-02-04 10:44:55 +01:00
cd freesewing
npm run kickstart
2024-02-04 10:44:55 +01:00
```
## Links 👩‍💻
2023-08-11 16:14:54 +02:00
**Official channels**
- 🪡 Makers website: [FreeSewing.eu](https://freesewing.eu)
2023-08-11 16:14:54 +02:00
- 💻 Developers website: [FreeSewing.dev](https://freesewing.dev)
**Social media**
- 🐘 Mastodon: [@freesewing](https://freesewing.social/@freesewing) on [FreeSewing.social](https://freesewing.social/)
- 🐘 Mastodon: [@joost](https://freesewing.social/@joost) on [FreeSewing.social](https://freesewing.social/)
2023-08-11 16:14:54 +02:00
**Places the FreeSewing community hangs out**
- 💬 [Forum](https://forum.freesewing.eu/)
2023-08-11 16:14:54 +02:00
- 💬 [Discord](https://discord.freesewing.org/)
- 💬 [Reddit](https://www.reddit.com/r/freesewing/)
## Where to get help 🤯
For [Support](https://freesewing.eu/support), please use the [forum](https://forum.freesewing.eu).
2024-02-04 10:52:16 +01:00
## License: MIT 🤓
© [Joost De Cock](https://github.com/joostdecock).
See [the license file](https://github.com/freesewing/freesewing/blob/develop/LICENSE) for details.