diff --git a/README.md b/README.md
index 5dccec5..b5b878d 100644
--- a/README.md
+++ b/README.md
@@ -43,8 +43,8 @@ Many companies and recruiters use [ATS](https://wikipedia.org/wiki/Applicant_tra
 
 You can use inline Markdown in the following properties to make text bold, italic, or link them to external pages:
 
-* `summary`
-* `highlights`
+- `summary`
+- `highlights`
 
 ### Open Graph Protocol
 
@@ -58,6 +58,6 @@ Includes a dark mode, and uses the [`prefers-color-scheme`](https://developer.mo
 
 This theme makes no external connections, doesn't embed scripts, and is lightweight by design. Both HTML and PDF exports will be minimal.
 
-## Preview 
+## Preview
 
 ![Two screenshots of the Class theme for JSON Resume side-by-side. On the left-side, we see the light mode variant, while on the right-side is the dark mode variant.](./assets/preview.png)
diff --git a/index.js b/index.js
index 40a83e5..48702fb 100644
--- a/index.js
+++ b/index.js
@@ -75,6 +75,112 @@ Handlebars.registerHelper('link', (body) => {
   return `<a href="${body}">${host}</a>`;
 });
 
+/**
+ * Many users still have JSON Resumes written against old versions of the
+ * schema. We detect this and upgrade them to the latest version behind the
+ * scenes.
+ *
+ * Writes to the object directly.
+ *
+ * @param {any} resume
+ * @returns {boolean}
+ *   If the JSON Resume was modified. (i.e. was using outdated property names)
+ *
+ * @see https://github.com/jsonresume/resume-schema/releases/tag/v0.0.17
+ * @see https://github.com/jsonresume/resume-schema/releases/tag/v0.0.12
+ */
+function upgradeOutdatedResume(resume) {
+  let upgraded = false;
+
+  if (resume.bio && !resume.basics) {
+    resume.basics = resume.bio;
+    upgraded = true;
+  }
+
+  if ((resume.basics?.firstName || resume.basics?.lastName) && !resume.basics.name) {
+    const names = [];
+
+    if (resume.basics.firstName) {
+      names.push(resume.basics.firstName);
+    }
+
+    if (resume.basics.lastName) {
+      names.push(resume.basics.lastName);
+    }
+
+    resume.basics.name = names.join(' ');
+    upgraded = true;
+  }
+
+  if (resume.basics?.picture && !resume.basics.image) {
+    resume.basics.image = resume.basics.picture;
+    upgraded = true;
+  }
+
+  if (resume.basics?.website && !resume.basics.url) {
+    resume.basics.url = resume.basics.website;
+    upgraded = true;
+  }
+
+  if (resume.basics?.state && !resume.basics?.region) {
+    resume.basics.region = resume.basics.state;
+    upgraded = true;
+  }
+
+  if (Array.isArray(resume.work)) {
+    for (const work of resume.work) {
+      if (work?.company && !work.name) {
+        work.name = work.company;
+        upgraded = true;
+      }
+
+      if (work?.website && !work.url) {
+        work.url = work.website;
+        upgraded = true;
+      }
+    }
+  }
+
+  if (Array.isArray(resume.volunteer)) {
+    for (const volunteer of resume.volunteer) {
+      if (volunteer?.website && !volunteer.url) {
+        volunteer.url = volunteer.website;
+        upgraded = true;
+      }
+    }
+  }
+
+  if (Array.isArray(resume.publications)) {
+    for (const publication of resume.publications) {
+      if (publication?.website && !publication.url) {
+        publication.url = publication.website;
+        upgraded = true;
+      }
+    }
+  }
+
+  if (resume.hobbies && !resume.interests) {
+    resume.interests = resume.hobbies;
+    upgraded = true;
+  }
+
+  if (Array.isArray(resume.languages)) {
+    for (const language of resume.languages) {
+      if (language?.name && !language.language) {
+        language.language = language.name;
+        upgraded = true;
+      }
+
+      if (language?.level && !language.fluency) {
+        language.fluency = language.level;
+        upgraded = true;
+      }
+    }
+  }
+
+  return upgraded;
+}
+
 /**
  * @param {any} resume
  * @returns {Promise<string>}
@@ -85,9 +191,12 @@ export async function render(resume) {
     fs.readFile(import.meta.dirname + '/resume.handlebars', 'utf-8'),
   ]);
 
-  const { profiles } = resume.basics;
+  if (upgradeOutdatedResume(resume)) {
+    console.warn('⚠️  Resume is written against an outdated version of the JSON Resume schema.\n⚠️  This will still work, but you should consider updating your resume.\n⚠️  See: https://jsonresume.org/schema');
+  }
 
-  if (Array.isArray(profiles)) {
+  if (Array.isArray(resume.basics?.profiles)) {
+    const { profiles } = resume.basics;
     const xTwitter = profiles.find((profile) => {
       const name = profile.network.toLowerCase();
       return name === 'x' || name === 'twitter';
@@ -114,7 +223,7 @@ export async function render(resume) {
     }
   }
 
-  const [ css, template ] = await loading;
+  const [css, template] = await loading;
   const html = Handlebars.compile(template)({
     css,
     resume
diff --git a/resume.handlebars b/resume.handlebars
index 47725ef..2acc6d0 100644
--- a/resume.handlebars
+++ b/resume.handlebars
@@ -4,372 +4,360 @@
 {{else}}
 <html>
 {{/if}}
-  <head>
-    {{#if resume.basics.name}}
-    <title>{{resume.basics.name}} - CV</title>
-    <meta property="og:site_name" content="{{resume.basics.name}}">
-    {{else}}
-    <title>CV</title>
-    {{/if}}
 
-    {{#if resume.basics.summary}}
-    <meta name="description" content="{{resume.basics.summary}}">
-    <meta property="og:description" content="{{resume.basics.summary}}">
-    {{/if}}
+<head>
+  {{#if resume.basics.name}}
+  <title>{{resume.basics.name}} - CV</title>
+  <meta property="og:site_name" content="{{resume.basics.name}}">
+  {{else}}
+  <title>CV</title>
+  {{/if}}
 
-    {{#if resume.basics.label}}
-    <meta property="og:title" content="{{resume.basics.label}}">
-    {{/if}}
+  {{#if resume.basics.summary}}
+  <meta name="description" content="{{resume.basics.summary}}">
+  <meta property="og:description" content="{{resume.basics.summary}}">
+  {{/if}}
 
-    {{#if resume.basics.image}}
-    <meta property="og:image" content="{{resume.basics.image}}">
-    <link rel="icon" href="{{resume.basics.image}}">
-    {{#if resume.basics.name}}
-    <meta property="og:image:alt" content="Avatar of {{resume.basics.name}}.">
-    {{/if}}
-    {{/if}}
+  {{#if resume.basics.label}}
+  <meta property="og:title" content="{{resume.basics.label}}">
+  {{/if}}
 
-    {{#if resume.custom.xTwitterHandle}}
-    <meta name="twitter:site" content="{{resume.custom.xTwitterHandle}}">
-    {{/if}}
+  {{#if resume.basics.image}}
+  <meta property="og:image" content="{{resume.basics.image}}">
+  <link rel="icon" href="{{resume.basics.image}}">
+  {{#if resume.basics.name}}
+  <meta property="og:image:alt" content="Avatar of {{resume.basics.name}}.">
+  {{/if}}
+  {{/if}}
 
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <meta name="twitter:card" content="summary">
-    <meta property="og:type" content="website">
+  {{#if resume.custom.xTwitterHandle}}
+  <meta name="twitter:site" content="{{resume.custom.xTwitterHandle}}">
+  {{/if}}
+
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="twitter:card" content="summary">
+  <meta property="og:type" content="website">
+
+  <style>
+    {{{css}}}
+  </style>
+</head>
 
-    <style>{{{css}}}</style>
-  </head>
-  <body>
+<body>
 
   {{#resume.basics}}
   <header>
-  <h1>{{name}}</h1>
-  {{#if label}}
-  <h2>{{label}}</h2>
-  {{/if}}
+    <h1>{{name}}</h1>
+    {{#if label}}
+    <h2>{{label}}</h2>
+    {{/if}}
   </header>
 
   <div id="content" class="container">
-  <section id="basics">
-    <div class="contact">
-    <h3>Contact</h3>
-    <div class="split">
-    {{#if url}}
-    <div class="website">
-      <strong>Website</strong>
-
-      {{{link url}}}
-    </div>
-    {{else if website}}
-    <div class="website">
-      <strong>Website</strong>
-      <a href="{{website}}">{{website}}</a>
-    </div>
-    {{/if}}
-    {{#if email}}
-    <div class="email">
-      <strong>Email</strong>
-      <a href="mailto:{{email}}">{{email}}</a>
-    </div>
-    {{/if}}
-    {{#if phone}}
-    <div class="phone">
-      <strong>Phone</strong>
-      <a href="tel:{{phone}}">{{phone}}</a>
-    </div>
-    {{/if}}
-    </div>
-    </div>
-    {{#if summary}}
-    <div class="summary">
-      <h3>About</h3>
-      <p>{{{markdown summary}}}</p>
-    </div>
-    {{/if}}
-    {{#if profiles.length}}
-    <section id="profiles" class="split">
-      {{#each profiles}}
-      <div class="item">
-        {{#if network}}
-        <strong class="network">
-          {{network}}
-        </strong>
-        {{/if}}
-        <div class="username">
+    <section id="basics">
+      <div class="contact">
+        <h3>Contact</h3>
+        <div class="split">
           {{#if url}}
-          <a href="{{url}}">
-            {{#if username}}
-              {{username}}
-            {{else}}
-              {{url}}
-            {{/if}}
-          </a>
-          {{else}}
-          {{username}}
+          <div class="website">
+            <strong>Website</strong>
+
+            {{{link url}}}
+          </div>
+          {{/if}}
+          {{#if email}}
+          <div class="email">
+            <strong>Email</strong>
+            <a href="mailto:{{email}}">{{email}}</a>
+          </div>
+          {{/if}}
+          {{#if phone}}
+          <div class="phone">
+            <strong>Phone</strong>
+            <a href="tel:{{phone}}">{{phone}}</a>
+          </div>
           {{/if}}
         </div>
       </div>
-      {{/each}}
-    </section>
-    {{/if}}
-  </section>
-  {{/resume.basics}}
-
-  {{#if resume.work.length}}
-  <section id="work">
-    <h2>Work Experience</h2>
-    {{#each resume.work}}
-    <div class="item">
-      {{#if name}}
-      <h3 class="work_name">
-        {{name}}
-      </h3>
-      {{else if company}}
-      <h3 class="work_name">
-        {{company}}
-      </h3>
-      {{/if}}
-
-      <div class="split">
-      {{#if position}}
-      <div class="work_position">
-        {{position}}
-      </div>
-      {{/if}}
-
-      <div class="work_date">
-        {{#if startDate}}
-        {{{date startDate}}} - {{{date endDate}}}
-        {{/if}}
-      </div>
-
-      {{#if url}}
-      <div class="work_website">
-        {{{link url}}}
-      </div>
-      {{else if website}}
-      <div class="work_website">
-        <a href="{{website}}">{{website}}</a>
-      </div>
-      {{/if}}
-      </div>
-
       {{#if summary}}
       <div class="summary">
+        <h3>About</h3>
         <p>{{{markdown summary}}}</p>
       </div>
       {{/if}}
-      {{#if highlights.length}}
-      <ul class="highlights">
-        {{#each highlights}}
-        <li>{{{markdown .}}}</li>
+      {{#if profiles.length}}
+      <section id="profiles" class="split">
+        {{#each profiles}}
+        <div class="item">
+          {{#if network}}
+          <strong class="network">
+            {{network}}
+          </strong>
+          {{/if}}
+          <div class="username">
+            {{#if url}}
+            <a href="{{url}}">
+              {{#if username}}
+              {{username}}
+              {{else}}
+              {{url}}
+              {{/if}}
+            </a>
+            {{else}}
+            {{username}}
+            {{/if}}
+          </div>
+        </div>
         {{/each}}
-      </ul>
+      </section>
       {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+    </section>
+    {{/resume.basics}}
 
-  {{#if resume.volunteer.length}}
-  <section id="volunteer">
-    <h2>Volunteer</h2>
-    {{#each resume.volunteer}}
-    <div class="item">
-      {{#if organization}}
-      <h3 class="company">
-        {{organization}}
-      </h3>
-      {{/if}}
+    {{#if resume.work.length}}
+    <section id="work">
+      <h2>Work Experience</h2>
+      {{#each resume.work}}
+      <div class="item">
+        {{#if name}}
+        <h3 class="work_name">
+          {{name}}
+        </h3>
+        {{/if}}
 
-      <div class="split">
-      {{#if position}}
-      <div class="work_position">
-        {{position}}
-      </div>
-      {{/if}}
+        <div class="split">
+          {{#if position}}
+          <div class="work_position">
+            {{position}}
+          </div>
+          {{/if}}
+
+          <div class="work_date">
+            {{#if startDate}}
+            {{{date startDate}}} - {{{date endDate}}}
+            {{/if}}
+          </div>
+
+          {{#if url}}
+          <div class="work_website">
+            {{{link url}}}
+          </div>
+          {{/if}}
+        </div>
 
-      <div class="work_date">
-        {{#if startDate}}
-        <span class="startDate">
-          {{{date startDate}}}
-        </span>
-        <span class="endDate">
-          - {{{date endDate}}}
-        </span>
+        {{#if summary}}
+        <div class="summary">
+          <p>{{{markdown summary}}}</p>
+        </div>
+        {{/if}}
+        {{#if highlights.length}}
+        <ul class="highlights">
+          {{#each highlights}}
+          <li>{{{markdown .}}}</li>
+          {{/each}}
+        </ul>
         {{/if}}
       </div>
+      {{/each}}
+    </section>
+    {{/if}}
 
-      {{#if url}}
-      <div class="work_website">
-        {{{link url}}}
-      </div>
-      {{else if website}}
-      <div class="work_website">
-        <a href="{{website}}">{{website}}</a>
-      </div>
-      {{/if}}
-      </div>
+    {{#if resume.volunteer.length}}
+    <section id="volunteer">
+      <h2>Volunteer</h2>
+      {{#each resume.volunteer}}
+      <div class="item">
+        {{#if organization}}
+        <h3 class="company">
+          {{organization}}
+        </h3>
+        {{/if}}
 
-      {{#if summary}}
-      <div class="summary">
-        <p>{{{markdown summary}}}</p>
-      </div>
-      {{/if}}
-      {{#if highlights.length}}
-      <ul class="highlights">
-        {{#each highlights}}
-        <li>{{{markdown .}}}</li>
-        {{/each}}
-      </ul>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+        <div class="split">
+          {{#if position}}
+          <div class="work_position">
+            {{position}}
+          </div>
+          {{/if}}
 
-  {{#if resume.education.length}}
-  <section id="education">
-    <h2>Education</h2>
-    {{#each resume.education}}
-    <div class="item">
+          <div class="work_date">
+            {{#if startDate}}
+            <span class="startDate">
+              {{{date startDate}}}
+            </span>
+            <span class="endDate">
+              - {{{date endDate}}}
+            </span>
+            {{/if}}
+          </div>
 
-      <div class="split">
-      {{#if institution}}
-      <div class="institution">
-        {{institution}}
-      </div>
-      {{/if}}
+          {{#if url}}
+          <div class="work_website">
+            {{{link url}}}
+          </div>
+          {{/if}}
+        </div>
 
-      <div class="study_date">
-        {{#if startDate}}
-        <span class="startDate">
-          {{{date startDate}}}
-        </span>
-        <span class="endDate">
-          - {{{date endDate}}}
-        </span>
+        {{#if summary}}
+        <div class="summary">
+          <p>{{{markdown summary}}}</p>
+        </div>
+        {{/if}}
+        {{#if highlights.length}}
+        <ul class="highlights">
+          {{#each highlights}}
+          <li>{{{markdown .}}}</li>
+          {{/each}}
+        </ul>
         {{/if}}
       </div>
+      {{/each}}
+    </section>
+    {{/if}}
 
-      {{#if url}}
-      <div class="work_website">
-        {{{link url}}}
-      </div>
-      {{/if}}
-      </div>
+    {{#if resume.education.length}}
+    <section id="education">
+      <h2>Education</h2>
+      {{#each resume.education}}
+      <div class="item">
 
-      {{#if qualification}}
-      <div class="qualification">
-        {{qualification}}
-      </div>
-      {{/if}}
+        <div class="split">
+          {{#if institution}}
+          <div class="institution">
+            {{institution}}
+          </div>
+          {{/if}}
 
-      {{#if courses.length}}
-      <ul class="courses">
-        {{#each courses}}
-        <li>{{.}}</li>
-        {{/each}}
-      </ul>
-      {{/if}}
+          <div class="study_date">
+            {{#if startDate}}
+            <span class="startDate">
+              {{{date startDate}}}
+            </span>
+            <span class="endDate">
+              - {{{date endDate}}}
+            </span>
+            {{/if}}
+          </div>
 
-      {{#if dissertation}}
-      <div class="dissertation">
-        <span>Dissertation: </span>{{dissertation}}
-      </div>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+          {{#if url}}
+          <div class="work_website">
+            {{{link url}}}
+          </div>
+          {{/if}}
+        </div>
+
+        {{#if qualification}}
+        <div class="qualification">
+          {{qualification}}
+        </div>
+        {{/if}}
+
+        {{#if courses.length}}
+        <ul class="courses">
+          {{#each courses}}
+          <li>{{.}}</li>
+          {{/each}}
+        </ul>
+        {{/if}}
 
-  {{#if resume.skills.length}}
-  <section id="skills">
-    <h2>Skills</h2>
-    {{#each resume.skills}}
-    <div class="item">
-      {{#if name}}
-      <div class="name">
-        {{name}}
+        {{#if dissertation}}
+        <div class="dissertation">
+          <span>Dissertation: </span>{{dissertation}}
+        </div>
+        {{/if}}
       </div>
-      {{/if}}
-      {{#if level}}
-      <div class="level">
-        <em>{{level}}</em>
+      {{/each}}
+    </section>
+    {{/if}}
+
+    {{#if resume.skills.length}}
+    <section id="skills">
+      <h2>Skills</h2>
+      {{#each resume.skills}}
+      <div class="item">
+        {{#if name}}
+        <div class="name">
+          {{name}}
+        </div>
+        {{/if}}
+        {{#if level}}
+        <div class="level">
+          <em>{{level}}</em>
+        </div>
+        {{/if}}
+        {{#if keywords.length}}
+        <ul class="keywords">
+          {{#each keywords}}
+          <li>{{.}}</li>
+          {{/each}}
+        </ul>
+        {{/if}}
       </div>
-      {{/if}}
-      {{#if keywords.length}}
-      <ul class="keywords">
-        {{#each keywords}}
-        <li>{{.}}</li>
-        {{/each}}
-      </ul>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+      {{/each}}
+    </section>
+    {{/if}}
 
-  {{#if resume.languages.length}}
-  <section id="languages">
-    <h2>Languages</h2>
-    {{#each resume.languages}}
-    <div class="item">
-      {{#if language}}
-      <div>{{language}}</div>
-      {{/if}}
-      {{#if fluency}}
-      <div class="level">
-        <em>{{fluency}}</em>
+    {{#if resume.languages.length}}
+    <section id="languages">
+      <h2>Languages</h2>
+      {{#each resume.languages}}
+      <div class="item">
+        {{#if language}}
+        <div>{{language}}</div>
+        {{/if}}
+        {{#if fluency}}
+        <div class="level">
+          <em>{{fluency}}</em>
+        </div>
+        {{/if}}
       </div>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+      {{/each}}
+    </section>
+    {{/if}}
 
-  {{#if resume.interests.length}}
-  <section id="interests">
-    <h2>Interests</h2>
-    {{#each resume.interests}}
-    <div class="item">
-      {{#if name}}
-      <div class="name">
-        {{name}}
+    {{#if resume.interests.length}}
+    <section id="interests">
+      <h2>Interests</h2>
+      {{#each resume.interests}}
+      <div class="item">
+        {{#if name}}
+        <div class="name">
+          {{name}}
+        </div>
+        {{/if}}
+        {{#if keywords.length}}
+        <ul class="keywords">
+          {{#each keywords}}
+          <li>{{.}}</li>
+          {{/each}}
+        </ul>
+        {{/if}}
       </div>
-      {{/if}}
-      {{#if keywords.length}}
-      <ul class="keywords">
-        {{#each keywords}}
-        <li>{{.}}</li>
-        {{/each}}
-      </ul>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+      {{/each}}
+    </section>
+    {{/if}}
 
-  {{#if resume.references.length}}
-  <section id="references">
-    <h2>References</h2>
-    {{#each resume.references}}
-    <div class="item">
-      {{#if reference}}
-      <blockquote class="reference">
-        {{reference}}
-      </blockquote>
-      {{/if}}
-      {{#if name}}
-      <div class="name">
-        — {{name}}
+    {{#if resume.references.length}}
+    <section id="references">
+      <h2>References</h2>
+      {{#each resume.references}}
+      <div class="item">
+        {{#if reference}}
+        <blockquote class="reference">
+          {{reference}}
+        </blockquote>
+        {{/if}}
+        {{#if name}}
+        <div class="name">
+          — {{name}}
+        </div>
+        {{/if}}
       </div>
-      {{/if}}
-    </div>
-    {{/each}}
-  </section>
-  {{/if}}
+      {{/each}}
+    </section>
+    {{/if}}
   </div>
-  </body>
+</body>
+
 </html>
diff --git a/test/fixture.resume.json b/test/fixture.resume.json
index 6c5603f..766868b 100644
--- a/test/fixture.resume.json
+++ b/test/fixture.resume.json
@@ -27,7 +27,7 @@
   },
   "work": [
     {
-      "name": "JSON Resume",
+      "company": "JSON Resume",
       "location": "Remote",
       "position": "Open Sourcerer 🧙‍♂️",
       "url": "https://jsonresume.org",
diff --git a/tsconfig.json b/tsconfig.json
index 52ccfca..41d565f 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -3,12 +3,15 @@
     "noEmit": true,
     "module": "preserve",
     "target": "es2021",
-    "lib": ["es2021"],
+    "lib": [
+      "es2021"
+    ],
     "allowJs": true,
     "checkJs": true,
     "strict": true,
     "resolveJsonModule": true,
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "noImplicitAny": false
   },
   "exclude": [
     ".yarn/",