{"id":34827351,"url":"https://github.com/profullstack/neon-builder","last_synced_at":"2026-04-27T02:32:02.063Z","repository":{"id":326700378,"uuid":"1106562493","full_name":"profullstack/neon-builder","owner":"profullstack","description":"A builder for selling AI generated digital products on sites like JVzoo and Clickbank.","archived":false,"fork":false,"pushed_at":"2025-11-29T14:15:31.000Z","size":84,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-27T00:52:36.425Z","etag":null,"topics":["cli","digital","generation","nodejs","products"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@profullstack/neon-builder","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/profullstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-29T13:57:43.000Z","updated_at":"2025-11-29T14:15:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/profullstack/neon-builder","commit_stats":null,"previous_names":["profullstack/neon-builder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/profullstack/neon-builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fneon-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fneon-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fneon-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fneon-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/profullstack","download_url":"https://codeload.github.com/profullstack/neon-builder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fneon-builder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32320261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","digital","generation","nodejs","products"],"created_at":"2025-12-25T15:20:27.657Z","updated_at":"2026-04-27T02:32:02.048Z","avatar_url":"https://github.com/profullstack.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neon Prompt Engine Builder\n\nA production-ready Node.js CLI tool for generating digital product bundles with AI-powered content, branded PDFs, and automated packaging.\n\n## Features\n\n- 🚀 **Interactive CLI** - Inquirer-based prompts with sensible defaults\n- 📊 **Progress Tracking** - Real-time progress bars for all operations\n- 🤖 **AI Content Generation** - OpenAI-powered content creation with retry logic\n- 📄 **Branded PDFs** - Puppeteer-based PDF generation with custom branding\n- 📦 **Automated Packaging** - ZIP archives for each section and master bundle\n- ⚙️ **Highly Configurable** - Override chunks, models, colors, and more\n\n## Requirements\n\n- Node.js 20 or newer\n- OpenAI API key\n- pnpm (recommended) or npm\n\n## Installation\n\n```bash\n# Clone or download the project\ncd neon-builder\n\n# Install dependencies\npnpm install\n```\n\n## Usage\n\n### Interactive Mode\n\nRun the CLI and follow the prompts:\n\n```bash\npnpm start\n```\n\nOn 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.\n\nOr use the binary directly:\n\n```bash\n./src/index.js\n```\n\n### Configuration Options\n\nThe CLI will prompt you for:\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| Root Folder | Output directory name | `NeonPromptEngine` |\n| Model | OpenAI model to use | `gpt-4` |\n| Temperature | Generation creativity (0-2) | `0.7` |\n| Generate PDFs | Create branded PDF files | `true` |\n| Primary Color | Brand primary color (hex) | `#00FFC8` |\n| Secondary Color | Brand secondary color (hex) | `#1a1a2e` |\n| Logo URL | URL to brand logo | - |\n| Footer Text | PDF footer text | `© Neon Prompt Engine` |\n\n### API Key Management\n\nYour OpenAI API key is stored securely in:\n```\n~/.config/neon-builder/credentials.json\n```\n\nThe CLI will:\n1. Check for `OPENAI_API_KEY` environment variable first\n2. Fall back to stored credentials in `~/.config/neon-builder/`\n3. Prompt you to enter a key if none is found\n4. Optionally save the key for future use\n\n### Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `OPENAI_API_KEY` | OpenAI API key (overrides stored credentials) |\n| `NEON_MODEL` | Override default model |\n| `NEON_OUTPUT_DIR` | Override output directory |\n| `NEON_VERBOSE` | Enable verbose logging (`true`/`false`) |\n\n## Sections\n\nThe builder generates content for these sections:\n\n| Section | Default Chunks | Description |\n|---------|----------------|-------------|\n| Core Prompts | 12 | 300 strategic prompts |\n| Premium Prompts | 14 | 700 advanced prompts |\n| Automation | 5 | 75 automation workflows |\n| Sales Pages | 5 | Funnel sales pages |\n| Thank You Pages | 5 | Post-purchase pages |\n| Launch Emails | 2 | Email sequences |\n| Affiliate Toolkit | 4 | JV/affiliate materials |\n| Branding Docs | 2 | Brand guidelines |\n| JVZoo Docs | 3 | Marketplace listings |\n| READMEs | 3 | Documentation files |\n\n## Output Structure\n\n```\nNeonPromptEngine/\n├── core_prompts/\n│   ├── chunk_01.txt\n│   ├── chunk_01.pdf\n│   └── ...\n├── premium_prompts/\n│   └── ...\n├── core_prompts.zip\n├── premium_prompts.zip\n└── NeonPromptEngine_complete.zip\n```\n\n## Development\n\n### Project Structure\n\n```\nneon-builder/\n├── src/\n│   ├── index.js           # Main CLI entry point\n│   ├── config/\n│   │   ├── sections.js    # Section definitions\n│   │   ├── defaults.js    # Default configuration\n│   │   └── index.js\n│   ├── generators/\n│   │   ├── content-generator.js  # OpenAI integration\n│   │   ├── pdf-generator.js      # Puppeteer PDF creation\n│   │   ├── zip-packager.js       # ZIP archive creation\n│   │   └── index.js\n│   ├── prompts/\n│   │   ├── cli-prompts.js # Inquirer prompts\n│   │   └── index.js\n│   └── utils/\n│       ├── progress.js    # Progress bars \u0026 logging\n│       ├── file-system.js # File operations\n│       └── index.js\n├── test/\n│   ├── config/\n│   ├── generators/\n│   └── utils/\n├── package.json\n├── vitest.config.js\n├── eslint.config.js\n└── .prettierrc\n```\n\n### Running Tests\n\n```bash\n# Run all tests\npnpm test\n\n# Run tests in watch mode\npnpm test:watch\n\n# Run tests with coverage\npnpm test:coverage\n```\n\n### Linting \u0026 Formatting\n\n```bash\n# Run ESLint\npnpm lint\n\n# Fix ESLint issues\npnpm lint:fix\n\n# Check formatting\npnpm format:check\n\n# Format code\npnpm format\n```\n\n## API Reference\n\n### Content Generator\n\n```javascript\nimport { createOpenAIClient, generateChunk, generateSection } from './generators/content-generator.js';\n\n// Create client\nconst client = createOpenAIClient(process.env.OPENAI_API_KEY);\n\n// Generate a single chunk\nconst content = await generateChunk(client, {\n  model: 'gpt-4',\n  temperature: 0.7,\n  section: sectionConfig,\n  chunkIndex: 0,\n  totalChunks: 5,\n  branding: brandingConfig,\n});\n```\n\n### PDF Generator\n\n```javascript\nimport { generateBrandedPdf, generateSectionPdfs } from './generators/pdf-generator.js';\n\n// Generate a single PDF\nawait generateBrandedPdf({\n  content: 'Your content here',\n  outputPath: './output/document.pdf',\n  title: 'Document Title',\n  sectionLabel: 'Section Name',\n  chunkNumber: 1,\n  totalChunks: 5,\n  branding: brandingConfig,\n});\n```\n\n### ZIP Packager\n\n```javascript\nimport { createSectionZip, createMasterZip } from './generators/zip-packager.js';\n\n// Create section ZIP\nconst zipPath = await createSectionZip({\n  sectionId: 'core_prompts',\n  sectionDir: './output/core_prompts',\n  outputDir: './output',\n});\n\n// Create master ZIP\nawait createMasterZip(sectionZipPaths, './output/master.zip');\n```\n\n## Dependencies\n\n### Production\n\n| Package | Purpose |\n|---------|---------|\n| `openai` | OpenAI API client |\n| `inquirer` | Interactive CLI prompts |\n| `cli-progress` | Progress bar display |\n| `puppeteer` | PDF generation |\n| `jszip` | ZIP archive creation |\n| `fs-extra` | Enhanced file operations |\n\n### Development\n\n| Package | Purpose |\n|---------|---------|\n| `vitest` | Test framework |\n| `@vitest/coverage-v8` | Code coverage |\n| `eslint` | Code linting |\n| `prettier` | Code formatting |\n\n## License\n\nMIT\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Write tests for new functionality\n4. Implement the feature\n5. Run tests and linting\n6. Submit a pull request\n\n## Roadmap\n\n- [ ] HTML sales page templates\n- [ ] React/Next.js PDF layouts\n- [ ] Image generation for banners\n- [ ] License key generator\n- [ ] S3 upload integration\n- [ ] Resume generation on API failure\n- [ ] Caching system\n- [ ] GUI dashboard version","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fneon-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprofullstack%2Fneon-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fneon-builder/lists"}