Site Builder
Editing:
readme.txt
writable 0666
Promptinator by Melanie AI - README.txt Last updated: July 29, 2025 =========================================================================== WHAT IS PROMPTINATOR? =========================================================================== Promptinator is a lightweight, zero-dependency JavaScript tool that turns static text into dynamic, interactive prompts using simple "tokens." These tokens transform into form elements like text boxes, radio buttons, checkboxes, dropdowns, and more, making your web content highly interactive without needing heavy frameworks. Key features: Dynamic tokens: Use shortcodes like [A-name-~Your name here~] to create text inputs, radios, checkboxes, dropdowns, URL pickers, and hidden fields. Inline editing: A pencil icon allows non-technical users to edit the raw prompt directly on the page. AI integration: "Think" mode adds buttons to send the filled prompt to ChatGPT, Perplexity, or Copilot. Business auto-fill: Automatically pulls business data (name, address, etc.) when window.businessData is set. Lightweight: Just one JS and one CSS file—no frameworks, no build steps. =========================================================================== 2. FILES IN THIS PACKAGE businessPromptinator.js: The core JavaScript module. promptinator.css: Styles for popups, buttons, and mobile responsiveness. README.txt: This file. Both files are standalone and can be dropped into any website. =========================================================================== 3. QUICK-START To get started: Add the CSS in your page's head: Link to promptinator.css using a standard HTML link tag with rel="stylesheet" and href="promptinator.css". Load the JavaScript module: Use a script tag with type="module". Inside the script, import Promptinator from './businessPromptinator.js' and initialize it by selecting all elements with class "Promptinator" and calling Promptinator.init with the mount element as an argument. Add a Promptinator div with tokens: Create a div with class="Promptinator" and optional attributes data-edit="1" and data-think="1". Inside the div, add tokens like [A-name-~Your name here~] just booked a [B-tone-|Standard|VIP|~VIP~] service on [D-date-31~1~] / [D-month-12~1~] / 2025. Reload the page. Click tokens to edit them, use the pencil to edit the raw prompt, or click AI buttons to send the prompt to ChatGPT, Perplexity, or Copilot. =========================================================================== 4. TOKEN CHEAT-SHEET Tokens are the heart of Promptinator. Here's what each type does: [A-label-~default~]: Text box or textarea with optional default text. [B-label-|Choice1|Choice2|~Default~]: Radio buttons (single choice). [C-label-|OptA|OptB|~Default~]: Checkboxes (multi-select). [D-label-10~3~]: Numeric dropdown (1 to 10, default 3). [D-label-|Opt1|Opt2|~Opt2~]: Text dropdown (default Opt2). [E-label-~email@example.com~]: Email submit button. [E-label-~https://example.com/submit~]: Form POST submit button. [I-label-|url1|url2|~Prompt~]: URL picker with iframe preview. [H-label-~hidden text~]: Hidden text (sent to AI but not shown). Business auto-fields (pulled from window.businessData): [name], [slogan], [description], [address], [city], [state], [zip], [phone], [website], [email] Business checkbox groups: [C-service-]: Checkbox list of service tags. [C-location-]: Checkbox list of location tags. =========================================================================== 5. DATA ATTRIBUTES FOR CONTROL You can control Promptinator's behavior using data attributes on the main div: data-edit="1": Show the pencil icon for inline editing (default: 1). data-think="1": Show AI buttons (ChatGPT, etc.) when no submit token is present (default: 1). data-prompt="...": Provide the raw prompt via JavaScript instead of inner text. Set to "0" or "false" to disable a feature. =========================================================================== 6. BUSINESS DATA AUTO-LOAD (OPTIONAL) If you set window.businessData, Promptinator will auto-fill tokens like [name] or [C-service-] with your business info. Example: Set window.businessData as an object with properties like: phone: "18005551234" (must match a URL parameter or segment), name: "Acme Pizza", slogan: "Hot & Ready in 20", address: "123 Main St", city: "Springfield", state: "IL", zip: "62701", website: "https://acmepizza.example", email: "order@acmepizza.example", tags: ["Delivery", "Carry-out"], location_tags: ["Downtown", "North Side"]. =========================================================================== 7. AI INTEGRATION ("THINK" MODE) When data-think="1" and there's no submit token, Promptinator shows buttons for ChatGPT, Perplexity, and Copilot. Clicking these opens the AI service with the filled prompt pre-loaded. Hidden [H-] tokens are included in the prompt but remain invisible on the page. =========================================================================== 8. INLINE EDITOR & SHORTCODE TOOLBAR Click the pencil to edit the raw prompt in a textarea. A dropdown above the textarea lets you insert new tokens with auto-numbered labels (e.g., label1, label2). =========================================================================== 9. ACCESSIBILITY, SECURITY, AND PRIVACY Tokens fall back to plain text if JavaScript is disabled. All controls are keyboard-navigable. No data is sent unless the user clicks an AI button or submit token. Email tokens use mailto: (opens user's email client). POST tokens submit to your HTTPS endpoint via an HTML form. =========================================================================== 10. EXTENDING PROMPTINATOR Promptinator is an ES module, so you can import and extend it easily. Example: Import Promptinator from './businessPromptinator.js'. Override the _popup method using a Proxy to log token interactions, then call the original method with Reflect.apply. =========================================================================== 11. LICENSE: MELANIE AI PROMPTINATOR DUAL-TIER LICENSE v1.0 A. PERSONAL USE Free for private, non-commercial projects. You may copy, modify, and use the software without payment. Attribution is appreciated but not required. B. COMMERCIAL USE Requires a license for any revenue-generating use, client projects, or resale. Contact Melanie Coates at support@quantaxtechnology.com for terms and pricing. C. PROHIBITIONS Do not remove copyright notices. Do not redistribute without a license. D. NO WARRANTY The software is provided "as is" without warranty. Use at your own risk. E. TRADEMARK "Promptinator" and "Melanie AI" are trademarks of Quanta X Technology. =========================================================================== 12. CONTRIBUTING Fork the repository, create a feature branch, and submit a pull request. Keep dependencies at zero. New UI must fit within promptinator.css. Run accessibility checks before submitting. =========================================================================== 13. CONTACT John Coates - Founder, RF Safe and LibertyUnites.tv Email: john@rfsafe.com https://bestdealon.com/promptinator/ See it in action =========================================================================== END OF README.txt
Save changes
Create folder
writable 0777
Create
Cancel