VULNRΞPO - Vulnerability Report Generator & Repository

A client-side, privacy-first vulnerability report manager for security professionals. All data is encrypted and stored locally in your browser — nothing is sent to any server by default.

Live app: https://vulnrepo.com/ | Dev branch: https://dev.vulnrepo.com/

Video walkthrough / Tutorial:

Table of Contents

• Features
• Security Model
• Supported Import Sources
• Report Export Formats
• Methodology Tools
• AI / LLM Integration
• Getting Started
  • Prerequisites
  • Development Server
  • Production Build
  • Docker
• Project Structure
• API Integration
• Browser Support
• Contributing
• License

Features

• Client-side encryption — reports are encrypted in the browser before storage; no backend required
• Issue templates — create and reuse custom vulnerability templates; import from CVE, CWE, MITRE ATT&CK, and PCI DSS
• Scanner imports — import findings directly from popular security tools (see Supported Import Sources)
• Multiple export formats — TXT, HTML, DOCX; generate PDF via browser print
• Encrypted HTML export — share an AES-encrypted, self-contained HTML report
• File attachments — attach screenshots, tool output, or any file; SHA-256 checksum is computed automatically
• Changelog — all significant report changes are versioned and logged automatically
• Issue export — export issues to SARIF 2.1.0, Atlassian Jira, or as a portable encrypted file
• Report sharing — share a full encrypted report with collaborators
• Report profiles — save reusable report configurations (logo, researcher info, theme, CSS)
• Template customization — edit the HTML report template and CSS directly in the app
• Methodology tools — built-in checklists for OWASP ASVS 4, PCI DSS 4, and The Bug Hunter's Methodology (TBHM)
• CVE search — query the NIST NVD database and pull CVE details into your report
• Report history — automatic versioned snapshots of every save
• Issue merge — merge duplicate or related issues
• Advanced filter — filter and search issues by severity, status, tags, CVE, CVSS, and more
• Bug bounty list — reference list of bug bounty programs
• AI / LLM integration — connect a local Ollama model for AI-assisted report writing (see AI / LLM Integration)
• Optional backend — store encrypted reports on your own server via the REST API (see API Integration)

Security Model

VULNRΞPO uses browser-native cryptography exclusively:

Key lifetime and auto-lock

Decryption passwords are held in a short-lived in-memory vault (KeyVaultService) that is cleared automatically when any of the following occur:

• Tab hidden — the browser tab loses focus or is switched away from (visibilitychange event)
• Tab closed / page reload — pagehide and beforeunload events
• Inactivity — 15 minutes of no keyboard, mouse, or touch input

After the vault is cleared, re-opening a report prompts for the password again. No key material is ever written to sessionStorage, localStorage, cookies, or any other persistent browser storage.

Reports encrypted with older versions of the app (legacy CryptoJS AES format) are automatically detected and decrypted for backward compatibility.

Important: There is no server-side key recovery. If you lose your security key, the report data cannot be recovered.

Supported Import Sources

Report Export Formats

Methodology Tools

The following interactive checklists are available from the sidebar:

• OWASP ASVS 4 — Application Security Verification Standard
• PCI DSS 4 — Payment Card Industry Data Security Standard
• TBHM — The Bug Hunter's Methodology

Use them during an assessment to ensure nothing is missed before finalizing the report.

AI / LLM Integration

VULNRΞPO integrates with Ollama to provide AI-assisted report writing using a locally hosted model. No data is sent to any cloud service.

Setup:

1. Install Ollama from ollama.com.
2. Pull and run a model:

   ollama run llama3.2:latest
   

3. Allow the VULNRΞPO origin to access Ollama. If using the hosted app, set the environment variable before starting Ollama:

   OLLAMA_ORIGINS=https://vulnrepo.com ollama serve
   

4. In VULNRΞPO, open AI Settings (robot icon in the report toolbar), enter your Ollama URL (http://localhost:11434 by default), select a model, and save.

Getting Started

Prerequisites

• Node.js 18 or later
• Angular CLI 22:

  npm install -g @angular/cli
  

Development Server

# Install dependencies
npm install

# Start the dev server
npm start
# or
ng serve

Navigate to http://localhost:4200/. The application reloads automatically when source files change.

Production Build

ng build -c production

Build artifacts are written to dist/vulnrepo-app/. Deploy the contents of that directory to any static web host or CDN.

Docker

The official Docker image is available on Docker Hub:

docker pull kac89/vulnrepo
docker run -p 8080:80 kac89/vulnrepo

See the image page for full documentation: https://hub.docker.com/r/kac89/vulnrepo

Project Structure

vulnrepo-master/
├── src/
│   ├── app/
│   │   ├── report/                   # Core report editor component
│   │   ├── myreports/                # Report list / dashboard
│   │   ├── newreport/                # Create report wizard
│   │   ├── import-report/            # Import encrypted report file
│   │   ├── templates-list/           # Issue template manager
│   │   ├── settings/                 # App settings (profiles, API vault)
│   │   ├── asvs/                     # OWASP ASVS 4 checklist
│   │   ├── pcidss4/                  # PCI DSS 4 checklist
│   │   ├── tbhm/                     # Bug Hunter's Methodology checklist
│   │   ├── cve-search/               # NVD CVE lookup
│   │   ├── bb-list/                  # Bug bounty program list
│   │   ├── faq/                      # In-app FAQ page
│   │   ├── crypto-utils.service.ts   # PBKDF2 + AES-GCM encryption service
│   │   ├── indexeddb.service.ts      # Local storage (IndexedDB) service
│   │   ├── api.service.ts            # Optional backend API service
│   │   ├── ollama-service.service.ts # Ollama LLM integration service
│   │   └── dialog-*/                 # Modal dialogs (add issue, import, export, …)
│   ├── assets/                       # Static assets, vendor logos
│   └── environments/                 # Environment configurations
├── dist/                             # Production build output
├── API-INTEGRATION.md                # Backend API reference
├── SECURITY.md                       # Vulnerability reporting policy
├── angular.json
└── package.json

API Integration

VULNRΞPO can optionally store encrypted reports on your own backend server. The API is a simple HTTP interface with a custom header-based authentication scheme.

See API-INTEGRATION.md for the full API reference.

An example server implementation is available at: https://github.com/kac89/vulnrepo-server

Browser Support

VULNRΞPO requires a modern browser with IndexedDB and Web Crypto API support. It does not work in private/incognito browsing mode (IndexedDB is blocked by most browsers in that mode).

Tested and supported:

• Google Chrome (latest)
• Mozilla Firefox (latest)
• Microsoft Edge (Chromium, latest)
• Safari on iOS (latest)
• Chrome on Android (latest)

Contributing

1. Fork the repository and create a feature branch from dev.
2. Make your changes and ensure the app builds without errors (ng build).
3. Submit a pull request against the dev branch.

To report a security vulnerability, see SECURITY.md.

License

VULNRΞPO is released under the Apache 2.0 License.