Neon Prompt Engine Builder

A production-ready Node.js CLI tool for generating digital product bundles with AI-powered content, branded PDFs, and automated packaging.

Features

• 🚀 Interactive CLI - Inquirer-based prompts with sensible defaults
• 📊 Progress Tracking - Real-time progress bars for all operations
• 🤖 AI Content Generation - OpenAI-powered content creation with retry logic
• 📄 Branded PDFs - Puppeteer-based PDF generation with custom branding
• 📦 Automated Packaging - ZIP archives for each section and master bundle
• ⚙️ Highly Configurable - Override chunks, models, colors, and more

Requirements

• Node.js 20 or newer
• OpenAI API key
• pnpm (recommended) or npm

Installation

# Clone or download the project
cd neon-builder

# Install dependencies
pnpm install

Usage

Interactive Mode

Run the CLI and follow the prompts:

pnpm start

On first run, you'll be prompted to enter your OpenAI API key. The key is securely stored in ~/.config/neon-builder/credentials.json for future use.

Or use the binary directly:

./src/index.js

Configuration Options

The CLI will prompt you for:

| Option | Description | Default | |--------|-------------|---------| | Root Folder | Output directory name | NeonPromptEngine | | Model | OpenAI model to use | gpt-4 | | Temperature | Generation creativity (0-2) | 0.7 | | Generate PDFs | Create branded PDF files | true | | Primary Color | Brand primary color (hex) | #00FFC8 | | Secondary Color | Brand secondary color (hex) | #1a1a2e | | Logo URL | URL to brand logo | - | | Footer Text | PDF footer text | © Neon Prompt Engine |

API Key Management

Your OpenAI API key is stored securely in:

~/.config/neon-builder/credentials.json

The CLI will:

1. Check for OPENAI_API_KEY environment variable first
2. Fall back to stored credentials in ~/.config/neon-builder/
3. Prompt you to enter a key if none is found
4. Optionally save the key for future use

Environment Variables

| Variable | Description | |----------|-------------| | OPENAI_API_KEY | OpenAI API key (overrides stored credentials) | | NEON_MODEL | Override default model | | NEON_OUTPUT_DIR | Override output directory | | NEON_VERBOSE | Enable verbose logging (true/false) |

Sections

The builder generates content for these sections:

| Section | Default Chunks | Description | |---------|----------------|-------------| | Core Prompts | 12 | 300 strategic prompts | | Premium Prompts | 14 | 700 advanced prompts | | Automation | 5 | 75 automation workflows | | Sales Pages | 5 | Funnel sales pages | | Thank You Pages | 5 | Post-purchase pages | | Launch Emails | 2 | Email sequences | | Affiliate Toolkit | 4 | JV/affiliate materials | | Branding Docs | 2 | Brand guidelines | | JVZoo Docs | 3 | Marketplace listings | | READMEs | 3 | Documentation files |

Output Structure

NeonPromptEngine/
├── core_prompts/
│   ├── chunk_01.txt
│   ├── chunk_01.pdf
│   └── ...
├── premium_prompts/
│   └── ...
├── core_prompts.zip
├── premium_prompts.zip
└── NeonPromptEngine_complete.zip

Development

Project Structure

neon-builder/
├── src/
│   ├── index.js           # Main CLI entry point
│   ├── config/
│   │   ├── sections.js    # Section definitions
│   │   ├── defaults.js    # Default configuration
│   │   └── index.js
│   ├── generators/
│   │   ├── content-generator.js  # OpenAI integration
│   │   ├── pdf-generator.js      # Puppeteer PDF creation
│   │   ├── zip-packager.js       # ZIP archive creation
│   │   └── index.js
│   ├── prompts/
│   │   ├── cli-prompts.js # Inquirer prompts
│   │   └── index.js
│   └── utils/
│       ├── progress.js    # Progress bars & logging
│       ├── file-system.js # File operations
│       └── index.js
├── test/
│   ├── config/
│   ├── generators/
│   └── utils/
├── package.json
├── vitest.config.js
├── eslint.config.js
└── .prettierrc

Running Tests

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage
pnpm test:coverage

Linting & Formatting

# Run ESLint
pnpm lint

# Fix ESLint issues
pnpm lint:fix

# Check formatting
pnpm format:check

# Format code
pnpm format

API Reference

Content Generator

import { createOpenAIClient, generateChunk, generateSection } from './generators/content-generator.js';

// Create client
const client = createOpenAIClient(process.env.OPENAI_API_KEY);

// Generate a single chunk
const content = await generateChunk(client, {
  model: 'gpt-4',
  temperature: 0.7,
  section: sectionConfig,
  chunkIndex: 0,
  totalChunks: 5,
  branding: brandingConfig,
});

PDF Generator

import { generateBrandedPdf, generateSectionPdfs } from './generators/pdf-generator.js';

// Generate a single PDF
await generateBrandedPdf({
  content: 'Your content here',
  outputPath: './output/document.pdf',
  title: 'Document Title',
  sectionLabel: 'Section Name',
  chunkNumber: 1,
  totalChunks: 5,
  branding: brandingConfig,
});

ZIP Packager

import { createSectionZip, createMasterZip } from './generators/zip-packager.js';

// Create section ZIP
const zipPath = await createSectionZip({
  sectionId: 'core_prompts',
  sectionDir: './output/core_prompts',
  outputDir: './output',
});

// Create master ZIP
await createMasterZip(sectionZipPaths, './output/master.zip');

Dependencies

Production

| Package | Purpose | |---------|---------| | openai | OpenAI API client | | inquirer | Interactive CLI prompts | | cli-progress | Progress bar display | | puppeteer | PDF generation | | jszip | ZIP archive creation | | fs-extra | Enhanced file operations |

Development

| Package | Purpose | |---------|---------| | vitest | Test framework | | @vitest/coverage-v8 | Code coverage | | eslint | Code linting | | prettier | Code formatting |

License

MIT

Contributing

1. Fork the repository
2. Create a feature branch
3. Write tests for new functionality
4. Implement the feature
5. Run tests and linting
6. Submit a pull request

Roadmap

• [ ] HTML sales page templates
• [ ] React/Next.js PDF layouts
• [ ] Image generation for banners
• [ ] License key generator
• [ ] S3 upload integration
• [ ] Resume generation on API failure
• [ ] Caching system
• [ ] GUI dashboard version