Skip to content

DevSA-009/JFT-Rapid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

349 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

JFT-Rapid

Automated Sportswear Layout Generator for Adobe Illustrator

License: MIT Adobe Illustrator ExtendScript Open Source

Switch Language:πŸ‡§πŸ‡© বাংলা


Β Β 

What is JFT-Rapid?

JFT-Rapid is a free, open-source Adobe Illustrator extension built specifically for sportswear printing businesses. If your team takes orders for jerseys, polo shirts, or sports pants β€” and you spend hours manually duplicating and arranging artwork for each player size β€” JFT-Rapid automates all of that for you.

You give it the player data (names, numbers, sizes). It takes your artwork layers, resizes them to the correct garment dimensions, arranges them on print-ready documents, and injects each player's name and number into the right text frames β€” automatically, for every size, every sleeve type, every garment part.

In short: What used to take hours now takes minutes.


Who Is This For?

JFT-Rapid is made for:

  • 🧡 Sportswear & jersey printing shops that handle bulk custom orders
  • 🎨 Graphic designers who manually lay out garment artwork in Illustrator
  • 🏭 Small-to-medium print production teams looking to reduce repetitive work
  • πŸ” Anyone who prints the same garment design across multiple sizes with custom player details

You do not need to be a developer to use this tool. If you can use Adobe Illustrator, you can use JFT-Rapid.


Recommended Adobe Version

Software Minimum Version Recommended
Adobe Illustrator CC 2020 (v24) CC 2024 (v28) or newer
Operating System Windows 10 Windows 10 / 11

Note: JFT-Rapid is designed and tested primarily on Windows. macOS support may work but is not officially tested.


Features

⚑ Automated Layout Generation

Stop duplicating artwork by hand. JFT-Rapid reads your order data and automatically generates print-ready EPS documents β€” one per garment part, per size group.

πŸ‘• Full Garment Pipeline

Handles the complete garment layout in one run:

  • Collar / Neck β€” Polo collars, plackets, and T-shirt neckbands
  • Rib / Cuff β€” Sleeve ribs and cuffs (quantity doubled automatically for CUFF type)
  • Short & Long Sleeves β€” Both sleeve types processed independently
  • Body β€” Main jersey body pieces
  • Short & Long Pants β€” Front and back pant pieces

πŸ”€ Dynamic Player Text Injection

Text frames named NAME and NUMBER inside your artwork are automatically filled with each player's data. Each player row in your order data can carry an optional SLEEVE field ("SHORT" or "LONG") and an optional PANT field ("SHORT" or "LONG") β€” the pipeline uses these to route each player to the correct garment piece automatically. Font sizes are auto-corrected if a long name would overflow the frame.

πŸ“ Smart Stack Layout Engine

JFT-Rapid tests five different stacking arrangements (HH, VV, RHH, RVV, VRH) and automatically picks the one that uses your paper width most efficiently.

πŸ“ Size Range Merging

Adjacent sizes with identical dimensions (e.g. XS+S, M+L) are grouped together on the same document, saving paper and reducing file count.

πŸ–₯️ Two Modes of Operation

Normal Mode (NA/NO): Full automation with player names and numbers. You provide a complete order in JSON format and every player's name and number is injected into the correct garment piece.

Static / Grid Mode: No player data needed. Just tell it the size quantities (e.g. M=10,L=8,2XL=3) and it generates layout grids for each garment part automatically.

πŸ“‹ Preparing Your Data

Player order data for Normal Mode follows this format per line:

SIZE---NAME---NUMBER---SLEEVE---RIB---PANT

To learn how to format data correctly, handle messy or unstructured orders, use AI tools to reformat raw data, or understand the full JSON structure β€” see the Data Format Guide

πŸ“¦ CEP Panel Interface

A clean panel UI inside Illustrator gives you one-click access to all features β€” no need to run scripts manually.

πŸ› οΈ Utility Tools

The panel also includes helper tools for common Illustrator tasks:

  • Add stroke outlines to clip paths
  • Check and repair opacity masks
  • Reset object names
  • Arrange and select objects by tag name
  • Generate and destroy object keys

How It Works (Simple Overview)

  1. Open your artwork in Adobe Illustrator. Each garment piece must be on the active layer and named with the correct marker tag (e.g. a body piece should have _BODY_ in its name).

  2. Open the JFT-Rapid panel from the Window menu.

  3. Click "Auto NA/NO" (Normal Mode) or "Grid Layout" (Static Mode).

  4. Enter your order data in the dialog that opens.

  5. Click Run. JFT-Rapid processes all garment parts, sizes, and players automatically β€” saving EPS files to the same folder as your source document.


Supported Garment Types

Type Sleeves Rib Pant
POLO Short, Long, or Both RIB / CUFF / None Short, Long, or Both
TSHIRT Short, Long, or Both RIB / CUFF / None Short, Long, or Both

Adult Sizes: XS Β· S Β· M Β· L Β· XL Β· 2XL Β· 3XL Β· 4XL Β· 5XL

Kids Sizes: 2 Β· 4 Β· 6 Β· 8 Β· 10 Β· 12 Β· 14 Β· 16


Installation

For full installation instructions including all supported paths, enabling unsigned extensions, and troubleshooting β€” see the Installation Guide.

Quick steps:

  1. Download the latest release from the Releases page.
  2. Copy the com.jftrapid.cep folder to one of these locations:
    • Windows (all users): C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\
    • Windows (current user): C:\Users\<YourUsername>\AppData\Roaming\Adobe\CEP\extensions\
    • macOS (all users): /Library/Application Support/Adobe/CEP/extensions/
  3. Enable unsigned extensions via the Windows Registry (one-time setup β€” see the full guide).
  4. Restart Adobe Illustrator.
  5. Open the panel from Window β†’ Extensions β†’ JFT Rapid.

The jft.conf file inside the extension folder contains garment dimensions per size. Edit it if your brand uses different measurements.


Project Structure (For the Curious)

JFT-Rapid/
β”œβ”€β”€ CLIENT/          ← Panel UI (HTML/CSS/JS shown inside Illustrator)
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ class/       ← All core logic classes (TypeScript)
β”‚   β”œβ”€β”€ enum/        ← Enums, constants, and test data
β”‚   β”œβ”€β”€ types/       ← TypeScript type definitions
β”‚   β”œβ”€β”€ polyfill/    ← ES6 polyfills for the ES3 ExtendScript runtime
β”‚   └── scriptUI/    ← ScriptUI dialog windows
β”œβ”€β”€ jft.conf         ← Brand/size configuration file
└── tsconfig.json    ← Compiles TypeScript β†’ single .jsx file

Open Source & Contributing

JFT-Rapid is open source and welcomes contributions from anyone β€” developers, designers, and print professionals alike.

Whether you want to:

  • πŸ› Report a bug
  • πŸ’‘ Suggest a new feature
  • πŸ”§ Fix something in the code
  • πŸ“– Improve the documentation
  • 🌐 Add support for a new language

...all contributions are welcome. Please read the Developer Documentation before contributing.


Credits

JFT-Rapid was created and is maintained by DevSA-009.

Special thanks to everyone in the sportswear printing community whose workflow challenges inspired this tool.


License

This project is licensed under the MIT License

You are free to use, modify, and distribute this software for any purpose, including commercial use, as long as the original copyright notice is preserved.