Applicant Profile Protocol (APP)

This repository contains the draft specification, JSON Schema, and examples for the Applicant Profile Protocol (APP).

Contents

• SPEC.md: Full protocol specification (draft)
• schema/app.schema.json: JSON Schema (v1) for validating APP profiles
• examples/minimal.json: Minimal valid APP profile
• examples/full.json: Full featured example with semantic and evidence layers
• docs/mappings/: Export mapping guides for JSON Resume, Europass, HR-XML
• docs/semantic/json-ld.md: Guidance for the optional JSON-LD semantic layer
• src/: Validator and exporters (Node.js)
• public/tools/: Online tools for creating, validating, and converting profiles

Validate an APP Profile

You can validate APP JSON using common validators.

Node.js (Ajv)

npm init -y
npm install ajv@8 ajv-formats
node -e "const Ajv=require('ajv');const addFormats=require('ajv-formats');const fs=require('fs');const schema=JSON.parse(fs.readFileSync('schema/app.schema.json'));const data=JSON.parse(fs.readFileSync('examples/full.json'));const ajv=new Ajv({allErrors:true});addFormats(ajv);const validate=ajv.compile(schema);console.log(validate(data)?'valid':'invalid',validate.errors||'');"

Python (jsonschema)

pip install jsonschema
python - << 'PY'
import json
from jsonschema import validate, Draft202012Validator
schema = json.load(open('schema/app.schema.json'))
instance = json.load(open('examples/full.json'))
Draft202012Validator.check_schema(schema)
validate(instance=instance, schema=schema)
print('valid')
PY

Online Tools

Use the browser-based tools at app-protocol.org — no installation required:

• Profile Builder — Create APP profiles using an intuitive form interface. Saves drafts to localStorage.
• Validator — Validate your APP JSON against the official schema with detailed error messages.
• Converter — Export APP profiles to JSON Resume, Europass XML, HR-XML, or JSON-LD.
• Importer — Import existing profiles from JSON Resume, Europass, HR-XML, or LinkedIn formats.

CLI Usage (Node)

Install dependencies and run the CLI:

npm install
npx app validate examples/full.json
npx app export:jsonresume examples/full.json > dist/full.jsonresume.json
npx app export:europass examples/full.json > dist/full.europass.xml
npx app export:hrxml examples/full.json > dist/full.hrxml.xml

Or via npm scripts:

npm run validate
npm run export:jsonresume
npm run export:europass
npm run export:hrxml
npm run export:jsonld

Exporters (Planned)

Guides and mappers to export APP → other formats:

• JSON Resume (implemented)
• Europass XML (minimal subset implemented)
• HR-XML (minimal subset implemented)
• ATS-specific payloads (planned)
• JSON-LD overlay (implemented)

Versioning

• Protocol uses Semantic Versioning.
• See SPEC.md for versioning policy.

Governance (Draft)

Open specification, community proposals, and backward compatibility encouraged.