2019-04-19 20:48:29 +02:00
|
|
|
<p align='center'><a
|
2023-09-07 11:39:34 +02:00
|
|
|
href="https://www.npmjs.com/package/@freesewing/core-plugins"
|
|
|
|
title="@freesewing/core-plugins on NPM"
|
|
|
|
><img src="https://img.shields.io/npm/v/@freesewing/core-plugins.svg"
|
|
|
|
alt="@freesewing/core-plugins on NPM"/>
|
2019-04-19 20:48:29 +02:00
|
|
|
</a><a
|
|
|
|
href="https://opensource.org/licenses/MIT"
|
|
|
|
title="License: MIT"
|
2023-09-07 11:39:34 +02:00
|
|
|
><img src="https://img.shields.io/npm/l/@freesewing/core-plugins.svg?label=License"
|
2019-04-19 20:48:29 +02:00
|
|
|
alt="License: MIT"/>
|
|
|
|
</a><a
|
2021-11-28 17:34:00 +01:00
|
|
|
href="#contributors-"
|
|
|
|
title="All Contributors"
|
2024-10-26 11:24:47 +02:00
|
|
|
><img src="https://img.shields.io/badge/all_contributors-131-pink.svg"
|
2021-11-28 17:34:00 +01:00
|
|
|
alt="All Contributors"/>
|
2019-04-21 12:57:12 +02:00
|
|
|
</a></p><p align='center'><a
|
2025-04-01 16:15:20 +02:00
|
|
|
href="https://forum.freesewing.org"
|
2019-04-19 20:48:29 +02:00
|
|
|
title="Follow @freesewing_org on Twitter"
|
2025-04-01 16:15:20 +02:00
|
|
|
><img src="https://img.shields.io/badge/%F3%A0%80%A0-Forum-E4405F.svg?logo=discourse&logoColor=white&logoWidth=15"
|
2019-04-19 20:48:29 +02:00
|
|
|
alt="Follow @freesewing_org on Twitter"/>
|
|
|
|
</a><a
|
2020-10-03 16:01:37 +02:00
|
|
|
href="https://chat.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"/>
|
2019-04-19 20:48:29 +02:00
|
|
|
</a><a
|
|
|
|
href="https://freesewing.org/patrons/join"
|
|
|
|
title="Become a FreeSewing Patron"
|
2019-04-21 12:57:12 +02:00
|
|
|
><img src="https://img.shields.io/badge/%F3%A0%80%A0-Support%20us-blueviolet.svg?logo=cash-app&logoColor=white&logoWidth=15"
|
2019-04-19 20:48:29 +02:00
|
|
|
alt="Become a FreeSewing Patron"/>
|
|
|
|
</a></p>
|
|
|
|
|
2023-09-07 11:39:34 +02:00
|
|
|
# @freesewing/core-plugins
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2025-04-21 18:20:52 +02:00
|
|
|
An umbrella package of essential plugins that are bundled with the FreeSewing core library
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2018-08-11 12:41:00 +02:00
|
|
|
|
2019-04-19 20:48:29 +02:00
|
|
|
# Plugins
|
2018-08-11 12:41:00 +02:00
|
|
|
|
|
|
|
1) [plugin-cutonfold](https://github.com/freesewing/plugin-cutonfold) : Add cut-on-fold indicators to your patterns
|
|
|
|
2) [plugin-dimension](https://github.com/freesewing/plugin-dimension) : Add dimensions to your (paperless) patterns
|
|
|
|
3) [plugin-grainline](https://github.com/freesewing/plugin-grainline) : Add grainline indicators to your patterns
|
2018-08-20 14:17:19 +02:00
|
|
|
4) [plugin-logo](https://github.com/freesewing/plugin-logo) : Add a scalebox to your patterns
|
|
|
|
5) [plugin-scalebox](https://github.com/freesewing/plugin-scalebox) : Add pretty titles to your pattern parts
|
|
|
|
6) [plugin-title](https://github.com/freesewing/plugin-title) : Add pretty titles to your pattern parts
|
2019-04-13 15:56:33 +02:00
|
|
|
7) [plugin-round](https://github.com/freesewing/plugin-title) : Rounds corners
|
|
|
|
8) [plugin-sprinkle](https://github.com/freesewing/plugin-sprinkle) : Add multiple snippets to your pattern
|
2018-08-11 13:50:46 +02:00
|
|
|
|
|
|
|
Note that these are all **build-time plugins**. In other words, plugins used by developers/pattern designers,
|
|
|
|
rather than run-time plugins that are used when generating patterns.
|
|
|
|
|
2018-08-20 14:17:19 +02:00
|
|
|
Without exception, all freesewing patterns use all these plugins, so it made sense to bundle them.
|
2018-08-11 13:50:46 +02:00
|
|
|
|
2018-08-11 12:41:00 +02:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
To load this plugin, add it to your instantiated pattern.
|
|
|
|
|
|
|
|
On node.js:
|
|
|
|
|
|
|
|
```js
|
2019-04-19 20:48:29 +02:00
|
|
|
import freesewing from '@freesewing/core'
|
|
|
|
import plugins from '@freesewing/plugin-bundle'
|
2018-08-11 12:41:00 +02:00
|
|
|
|
2019-04-19 20:48:29 +02:00
|
|
|
let pattern = new freesewing.Pattern().with(plugins);
|
2018-08-11 12:41:00 +02:00
|
|
|
```
|
2019-04-19 20:09:30 +02:00
|
|
|
|
|
|
|
|
2024-02-04 10:52:16 +01:00
|
|
|
# FreeSewing
|
|
|
|
|
|
|
|
> [!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
|
2025-04-01 16:15:20 +02:00
|
|
|
hardship, then you should [join us and become a patron](https://freesewing.eu/patrons/join).
|
2022-08-23 13:33:08 +02:00
|
|
|
|
2021-02-06 10:25:28 +01:00
|
|
|
## What am I looking at? 🤔
|
|
|
|
|
2023-09-30 17:40:53 +02:00
|
|
|
This repository is the FreeSewing *monorepo* holding all FreeSewing's websites, documentation, designs, plugins, and other NPM packages.
|
2021-02-06 10:25:28 +01:00
|
|
|
|
2023-09-07 11:39:34 +02:00
|
|
|
This folder holds: @freesewing/core-plugins
|
2021-02-06 10:25:28 +01:00
|
|
|
|
2022-06-17 18:23:17 +02:00
|
|
|
If you're not entirely sure what to do or how to start, type this command:
|
|
|
|
|
|
|
|
```
|
|
|
|
npm run tips
|
|
|
|
```
|
|
|
|
|
2024-02-04 10:52:16 +01:00
|
|
|
> [!NOTE]
|
2022-06-21 11:11:34 +02:00
|
|
|
> If you don't want to set up a dev environment, you can run it in your browser:
|
|
|
|
>
|
2025-04-01 16:15:20 +02:00
|
|
|
> [](https://gitpod.io/#https://codeberg.org/freesewing/freesewing)
|
2022-06-21 11:11:34 +02:00
|
|
|
>
|
|
|
|
> We recommend that you fork our repository and then
|
|
|
|
> put `gitpod.io/#<entire-url-of-your-fork` into a browser
|
|
|
|
> to start up a browser-based dev environment of your own.
|
|
|
|
|
2019-10-24 18:52:12 +02:00
|
|
|
## About FreeSewing 💀
|
2019-04-19 20:09:30 +02:00
|
|
|
|
|
|
|
Where the world of makers and developers collide, that's where you'll find FreeSewing.
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
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.
|
2021-02-06 10:19:57 +01:00
|
|
|
|
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
|
2021-02-06 10:19:57 +01:00
|
|
|
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:
|
2019-04-19 20:09:30 +02:00
|
|
|
|
|
|
|
```bash
|
2025-04-01 16:15:20 +02:00
|
|
|
npx @freesewing/studio
|
2019-04-19 20:09:30 +02:00
|
|
|
```
|
|
|
|
|
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/)
|
2019-04-19 20:09:30 +02:00
|
|
|
|
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.
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2024-02-04 10:52:16 +01:00
|
|
|
## Getting started ⚡
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2024-02-04 10:52:16 +01:00
|
|
|
To get started with FreeSewing, you can spin up our development environment with:
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2024-02-04 10:52:16 +01:00
|
|
|
```bash
|
2025-04-01 16:15:20 +02:00
|
|
|
npx @freesewing/studio
|
2024-02-04 10:52:16 +01:00
|
|
|
```
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
To work with FreeSewing's monorepo, you'll need [NodeJS v20](https://nodejs.org) on your system.
|
|
|
|
Once you have that, clone (or fork) this repo and run `npm run kickstart`:
|
2024-02-04 10:52:16 +01:00
|
|
|
|
|
|
|
```bash
|
2025-04-01 16:15:20 +02:00
|
|
|
git clone git@codeberg.org:freesewing/freesewing.git
|
2024-02-04 10:52:16 +01:00
|
|
|
cd freesewing
|
2025-04-01 16:15:20 +02:00
|
|
|
npm run kickstart
|
2024-02-04 10:52:16 +01:00
|
|
|
```
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2019-04-19 20:48:29 +02:00
|
|
|
## Links 👩💻
|
2019-04-19 20:09:30 +02:00
|
|
|
|
2023-09-30 17:40:53 +02:00
|
|
|
**Official channels**
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
- 💻 Makers website: [FreeSewing.eu](https://freesewing.eu/)
|
|
|
|
- 💻 Developers website: [FreeSewing.dev](https://freesewing.dev/)
|
|
|
|
- ✅ [Support](https://forum.freesewing.eu/),
|
|
|
|
[Issues](https://codeberg.org/freesewing/freesewing/issues) &
|
|
|
|
[Codeberg](https://codeberg.org/freesewing/freesewing)
|
2023-09-30 17:40:53 +02:00
|
|
|
|
|
|
|
**Social media**
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
- 🐘 Mastodon: [@freesewing](https://freesewing.social/@freesewing) on [FreeSewing.social](https://freesewing.social/)
|
|
|
|
- 🐘 Mastodon: [@joost](https://freesewing.social/@joost) on [FreeSewing.social](https://freesewing.social/)
|
2019-04-19 20:48:29 +02:00
|
|
|
|
2023-09-30 17:40:53 +02:00
|
|
|
**Places the FreeSewing community hangs out**
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
- 💬 [Forum](https://forum.freesewing.eu/)
|
2023-09-30 17:40:53 +02:00
|
|
|
- 💬 [Discord](https://discord.freesewing.org/)
|
|
|
|
- 💬 [Reddit](https://www.reddit.com/r/freesewing/)
|
|
|
|
|
2019-04-19 20:48:29 +02:00
|
|
|
## License: MIT 🤓
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
© [Joost De Cock](https://codeberg.org/joostdecock).
|
|
|
|
See [the license file](https://codeberg.org/freesewing/freesewing/blob/develop/LICENSE) for details.
|
2019-04-19 20:48:29 +02:00
|
|
|
|
|
|
|
## Where to get help 🤯
|
|
|
|
|
2025-04-01 16:15:20 +02:00
|
|
|
For [Support](https://freesewing.eu/support), please use the [forum](https://forum.freesewing.eu).
|
2021-11-27 20:06:56 +01:00
|
|
|
|