unicornmaxxing

Interactive npm CLI that asks what you're building, maps your stack choices, generates a Mermaid diagram, and bootstraps .env + contact_info.json for first-run setup.

Install

• Run with npx: npx @monzingo89/unicornmaxxing
• Or install globally: npm i -g @monzingo89/unicornmaxxing

Quick start with your Microsoft preset:

• npx @monzingo89/unicornmaxxing --presets microsoft

Run locally

• npm install
• npm start

Preset profiles

Use a preset to prefill a common stack and optionally skip those prompt questions:

• npm start -- --presets microsoft
• npm start -- --preset google
• npm start -- --preset aws

Other CLI options:

• npm start -- --list-presets
• npm start -- --help

When a preset is selected, the wizard asks whether to use preset values directly (ask only missing values) or keep prompts interactive with preset defaults preselected.

What it does

• Asks for:
  • build target (script, app, webpage)
  • app framework (Ionic, Cordova) when target is app
  • Ionic API client (Angular, React, Vue, Blazor) when app uses Ionic
  • identity provider (Firebase, Microsoft Entra External ID)
  • auth methods (multi-select)
  • API tech, database, repo host, domain host, API docs, email capability
• Produces Mermaid output and writes today-build-plan.mmd.
• Once approved, asks for environment secrets one-by-one.
• Writes .env, .env.example, and optional contact_info.json for Azure domain creation.

Included presets

• microsoft: Ionic + Blazor + Microsoft Entra External ID + C# + Microsoft SQL + GitHub
• google: Ionic + Angular + Firebase + Node + Firestore + GitHub
• aws: Cordova + Firebase + Go + MySQL + GitLab

Azure domain command template

If Azure domain automation is enabled, the wizard prepares values for:

az appservice domain create --resource-group <need-resource-group> --hostname example.com --contact-info @contact_info.json --accept-terms

New: One-page dynamic website (Azure-ready)

This repository now includes a standalone dynamic website under web/.

Local run

• Start the site: npm --prefix web start
• Open: http://localhost:8080
• Health/data endpoint: http://localhost:8080/api/site

Azure deployment assets

• azure.yaml configures AZD to deploy web/ to Azure App Service.
• infra/main.bicep provisions:
  • Linux App Service Plan (B1)
  • Web App (Node 20)
  • Log Analytics workspace
  • Application Insights
• infra/main.parameters.json maps AZD environment values.

Domain purchase + binding target

Target domain: robertjmonzingo.com

Pre-check result (from Azure CLI):

• hostname_available: true
• hostname_purchase_price: $11.99 USD

You can purchase and bind with Azure App Service Domain flow:

1. Purchase domain with az appservice domain create ... --accept-terms
2. Add custom hostname to your web app
3. Create managed certificate
4. Bind certificate via SNI

Current live deployment

• App URL: https://app-prod-ye26qh5p.azurewebsites.net
• API URL: https://app-prod-ye26qh5p.azurewebsites.net/api/site

Domain purchase note:

• Azure App Service Domain purchase attempt failed on this subscription with eligibility error (59743).
• Use external registrar purchase, then follow domain/domain-setup.md for DNS + Azure binding.

Publish

1. Update package name/version in package.json.
2. Login to npm: npm login.
3. Publish: npm publish --access public.