TypeScript Ready Zod Validation JSON Schema

Complete Schema for Developer Portfolios

The only TypeScript-first JSON schema you need for professional developer portfolios. Built with modern web standards and enhanced with powerful validation.

Get Started on GitHub View on NPM

50+

Schema Fields

Zero

Dependencies

100%

TypeScript

* Runtime dependencies: 0

portfolio.ts

import  DevFolioSchema  from 'devfolio-json-schema';

// Your portfolio data with full TypeScript support
const portfolio = 
  basics: 
    name: "John Doe",
    label: "Full Stack Developer",
    email: "john@example.com",
    website: "https://johndoe.dev"
  ,
  skills: [...],
  experience: [...]
;

// Validate with detailed error messages
const result = DevFolioSchema.safeParse(portfolio);

Why Choose DevFolio JSON Schema?

Modern developer portfolios need modern solutions. Built with TypeScript, validated with Zod, and designed for the future.

TypeScript First

Built from the ground up with TypeScript. Get full intellisense, type safety, and compile-time validation for your portfolio data.

Zod Validation

MOOC Support

First-class support for online courses, certifications, and modern learning platforms like Coursera, edX, and Udemy.

Professional Ready

Comprehensive fields for work experience, skills assessment, and professional achievements that recruiters want to see.

Modern Web

Support for social profiles, digital portfolios, and modern web presence including GitHub, LinkedIn, and personal websites.

Zero Dependencies

No runtime dependencies means smaller bundle sizes and fewer security concerns. Pure TypeScript with optional Zod validation.

Complete Schema Coverage

Every aspect of your professional profile, organized and validated

Core Information

basics - Personal information and contact details

social - Social media and professional profiles

experience - Work history with detailed descriptions

education - Academic background and degrees

Skills & Expertise

skills - Technical and soft skills with ratings

certifications - Professional certifications with expiry

moocs - Online courses and specializations

projects - Portfolio projects with technologies

Additional Sections

awards - Recognition and awards received

achievements - Professional milestones

languages - Spoken languages with proficiency levels

Advanced Sections

volunteer - Community involvement

publications - Articles, papers, and technical writings

references - Professional references and recommendations

See It In Action

Explore different sections of the schema with real examples

basics-example.json


  "basics": 
    "name": "John Doe",
    "label": "Senior Full Stack Developer",
    "picture": "https://johndoe.dev/avatar.jpg",
    "email": "john@johndoe.dev",
    "phone": "+1-555-0123",
    "website": "https://johndoe.dev",
    "summary": "Experienced developer with 8+ years in web technologies...",
    "location": 
      "address": "123 Tech Street",
      "city": "San Francisco",
      "region": "CA",
      "postalCode": "94105",
      "countryCode": "US"

experience-example.json


  "experience": [
    
      "company": "TechCorp Inc.",
      "position": "Senior Full Stack Developer",
      "startDate": "2021-06-01",
      "endDate": "2024-07-28",
      "summary": "Led development of scalable web applications...",
      "highlights": [
        "Increased application performance by 40%",
        "Mentored 5 junior developers",
        "Implemented CI/CD pipeline reducing deployment time by 60%"
      ],
      "technologies": ["React", "Node.js", "PostgreSQL", "AWS"]
    
  ]

skills-example.json


  "skills": [
    
      "name": "TypeScript",
      "level": "expert",
      "category": "programming-languages",
      "yearsOfExperience": 5,
      "rating": 9,
      "lastUsed": "2024-07-28",
      "keywords": ["JavaScript", "Static Typing", "ES6+"],
      "certifications": ["Microsoft TypeScript Certification"]
    ,
    
      "name": "Leadership",
      "level": "advanced",
      "category": "soft-skills",
      "yearsOfExperience": 3,
      "keywords": ["Team Management", "Mentoring"]
    
  ]

moocs-example.json


  "moocs": [
    
      "courseTitle": "AWS Cloud Solutions Architect Specialization",
      "type": "Specialization",
      "status": "Completed",
      "provider": "Coursera",
      "certificateLink": "https://coursera.org/verify/...",
      "courses": [
        
          "title": "AWS Cloud Technical Essentials",
          "certificateLink": "https://coursera.org/verify/...",
          "skills": ["AWS EC2", "AWS S3", "AWS IAM"]
        
      ],
      "skills": ["AWS", "Cloud Architecture", "DevOps"],
      "duration": 120
    
  ]

projects-example.json


  "projects": [
    
      "name": "E-Commerce Microservices Platform",
      "type": "professional",
      "status": "completed",
      "description": "Scalable platform with microservices architecture",
      "highlights": [
        "Built event-driven architecture with Apache Kafka",
        "Achieved 99.9% uptime in production",
        "Processed $2M+ in transactions"
      ],
      "technologies": [
        "Node.js", "TypeScript", "Apache Kafka",
        "PostgreSQL", "Docker", "Kubernetes"
      ],
      "role": "Lead Backend Developer",
      "teamSize": 8
    
  ]

Get Started in Minutes

Install DevFolio JSON Schema and start building type-safe portfolios immediately

Install the Package

# npm
npm install devfolio-json-schema

# yarn
yarn add devfolio-json-schema

# pnpm
pnpm add devfolio-json-schema

Import and Use

import  DevFolioSchema  from 'devfolio-json-schema';

// Validate your portfolio
const result = DevFolioSchema.safeParse(portfolio);

Build Your Portfolio

// Full TypeScript support
const portfolio: DevFolioType = 
  basics:  ... ,
  skills: [ ... ],
  // Intellisense everywhere!
;

How We Compare

See why developers choose DevFolio JSON Schema over other solutions

Feature	DevFolio Schema	JSON Resume	Custom Solutions
TypeScript Support	✅ Full native support	❌ No built-in support	⚠️ Manual implementation
Validation	✅ Zod with detailed errors	⚠️ JSON Schema only	❌ Usually none
MOOC Support	✅ First-class support	❌ Not supported	⚠️ Custom implementation
Modern Certifications	✅ Expiry tracking, digital badges	⚠️ Basic support	⚠️ Usually limited
Skills Management	✅ Advanced categorization	⚠️ Basic list	⚠️ Varies
Documentation	✅ Comprehensive	⚠️ Limited	❌ Usually poor
Maintenance	✅ Active development	⚠️ Slow updates	❌ Your responsibility

Ready to Build Better Portfolios?

Join developers who are already using DevFolio JSON Schema to create standardized, type-safe portfolios.

Get Started on GitHub View on NPM