A configurable Typst template to generate FDA-style nutrition fact labels. This package automates the layout and daily value percentage calculations, allowing you to create professional, accurate labels with minimal effort.

View Example PDF · View Example Typst File

Features

• Automatic DV Calculation: Automatically calculates the % Daily Value based on the latest FDA reference data.
• Highly Configurable: Adjust the font, scale the entire label, and toggle the footnote with optional parameters.
• Pixel-Perfect Layout: Faithfully reproduces the official FDA nutrition label’s fonts, weights, indentation, and line spacing.
• Flexible Micronutrients: Dynamically generates the list of vitamins and minerals. Add, remove, or reorder them as needed.

Usage

1. Import the Package
   Add the following line to your document’s preamble:

   #import "@preview/nutrition-label-nam:0.2.0": nutrition-label-nam
   

   (Note: Remember to update the version number as new releases become available.)

2. Define Your Data
   Create a dictionary with your product’s nutritional information. See the Data Structure section for details.

   #let sample-data = (
     servings: "8",
     serving_size: "2/3 cup (55g)",
     calories: "230",
     total_fat: (value: 8, unit: "g"),
     saturated_fat: (value: 1, unit: "g"),
     trans_fat: (value: 0, unit: "g"),
     cholesterol: (value: 0, unit: "mg"),
     sodium: (value: 160, unit: "mg"),
     carbohydrate: (value: 37, unit: "g"),
     fiber: (value: 4, unit: "g"),
     sugars: (value: 12, unit: "g"),
     added_sugars: (value: 10, unit: "g"),
     protein: (value: 3, unit: "g"),
     micronutrients: (
       (name: "Vitamin D", key: "vitamin_d", value: 2, unit: "mcg"),
       (name: "Calcium", key: "calcium", value: 260, unit: "mg"),
       (name: "Iron", key: "iron", value: 8.0, unit: "mg"),
       (name: "Potassium", key: "potassium", value: 240, unit: "mg"),
     ),
   )
   

3. Call the Function
   Call the nutrition-label-nam function with your data to render the label.

   #nutrition-label-nam(sample-data)
   

Parameters

The nutrition-label-nam function accepts the following optional parameters to customize its appearance:

Example with Options

#nutrition-label-nam(
  sample-data,
  font: "Tex Gyre Heros",
  scale-percent: 75%,
  show-footnote: false,
)

Data Structure

The main data dictionary requires keys for servings, serving_size, calories, and then a dictionary for each nutrient.

• Main Nutrients: (e.g., total_fat, sodium) require a dictionary with a value (number) and unit (string).
• Micronutrients: The micronutrients key holds an array of dictionaries. This allows you to list any number of vitamins and minerals. Each must have a name, key (for DV calculation), value, and unit.

micronutrients: (
  (name: "Vitamin D", key: "vitamin_d", value: 2, unit: "mcg"),
  (name: "Calcium", key: "calcium", value: 260, unit: "mg"),
  // ... add as many as you need
)

Daily Value Automation

The package automatically calculates the % Daily Value for nutrients based on the internal database below. To ensure correct calculation, provide the nutrient value in the unit specified by the FDA. The key in your micronutrients data must match a key from this table. In case you want to enter the DV% yourself or have micronutrients not found in this table, please use V0.1.0 that allows for this.

%DV for Protein and Trans Fat is intentionally not calculated, in accordance with standard FDA labeling practices.

Source: FDA Daily Value Reference Tables

⚠️ Disclaimer
This package is provided as-is for design and templating purposes. The automatic calculation is a convenience feature. It is your responsibility to ensure all data provided is accurate and that the final rendered label complies with all applicable FDA regulations for your product. The authors of this package are not liable for any mislabeling.