freesewing/markdown/dev/tutorials/pattern-design/adding-measurements/en.md

title	order
Adding measurements	130

FreeSewing is all about made-to-measure sewing patterns; we are going to draft our pattern according to the measurements provided to us.

Which begs the question, which measurements?

It is you, as the pattern designer, who decides which measurements are used to draft your pattern. For our bib, the only measurement we need is the head circumference.

So let's add it as a required measurement.

Adding required measurements

In our bib.mjs file, on the bib object, we'll add a new key called measurements that will hold a list (an array) of all required measurements for this part.

We are going to use the official name of the measurement. For head circumference, that name is head.

function draftBib({ part }) {

  return part
}

export const bib = {
  name: 'tutorial.bib',
  draft: draftBib,
  // Add this line:
  measurements: ['head'],
}

Now everybody knows this part requires the head measurement.

This change will also get picked up by the development environment, and you'll now see this screen:

Since it's just one measurement, let's simply enter a value by hand. For example 38 as 38cm is a realistic head circumference measurement for a baby.

Enter 38 in the box, and click on Draft Design in the sidebar under the View heading. This brings you back to our work in progress:

Notes

Why using standard measurements names matters

In principle, you can use any name you want for your measurements. Our core library really doesn't care.

However, if everybody uses their own (names for) measurements, then people aren't able to re-use their measurements across designs.

So if you have any intention at all to play nice with the FreeSewing ecosystem, please make sure to re-use the names of existing measurements, rather than invent your own.

See our best practices on this topic for details.