Transform branch changes into manageable plugins. Taylored is a command-line tool to expertly manage and apply .taylored
plugins, enabling conditional and atomic source code modifications with full Git integration.
Taylored helps you streamline source code modifications by treating them as "plugins" or "patches." These are stored in .taylored
files, which essentially capture git diff
outputs.
A key feature is Taylored's intelligent plugin generation:
- The
--save
command creates a.taylored
file only if the changes between a specified branch andHEAD
consist exclusively of line additions or exclusively of line deletions. This ensures plugins are atomic and well-defined, simplifying application and management. - The
--automatic
command can scan your codebase for special markers, extract these blocks, and generate.taylored
files for them, even supporting dynamic content generation via acompute
attribute.
Taylored also provides robust tools for patch lifecycle management:
--offset
: Updates patch offsets to keep them applicable as your codebase evolves.
- Atomic Changes: Ensure that applied modifications are clean and focused, either purely additive or purely deletive.
- Versionable Modifications: Treat complex or conditional code snippets as versionable plugins.
- Git-Powered: Leverages Git's robust diffing and applying capabilities.
- Automation: Automatically extract and manage tagged code blocks as individual patches.
- Dynamic Content: Generate parts of your patches dynamically using executable script blocks.
- Monetization: Easily package and sell your
.taylored
plugins, or acquire plugins from others to enhance your projects, leveraging the Taysell backend integration.
The recommended way to install Taylored is globally via npm, making the taylored
command available system-wide:
npm install -g taylored
Ensure you have Node.js and npm installed. After installation, run taylored
for a list of commands.
Taylored can be used to manage various project templates. One such template is:
- Backend-in-a-Box: A Node.js Express application template designed for selling digital patches. It now includes PayPal integration for payment processing, allowing developers to easily monetize their creations. Features include secure patch delivery, webhook handling, and database integration for purchase tracking. Taylored now includes direct CLI support for monetizing these patches through the
setup-backend
,create-taysell
, andtaylored --buy
commands, streamlining the process from server setup to patch sales and acquisition.- Key Setup: Requires configuration of PayPal API credentials, a webhook, and a patch encryption key via environment variables. Encrypted patch files must be placed in the
patches/
directory.
- Key Setup: Requires configuration of PayPal API credentials, a webhook, and a patch encryption key via environment variables. Encrypted patch files must be placed in the
For more detailed information on Taylored commands, advanced usage, development setup, and contributing, please see our Comprehensive Documentation.