Skip to content

Turn your Netlify CMS collections into TypeScript typings!

License

Notifications You must be signed in to change notification settings

29ki/netlify-ts

 
 

Repository files navigation

Netlify Type Generator

Build Status Supported Node versions Code coverage Project license

Turn your Netlify CMS collections into TypeScript typings!


This package generates a TypeScript schema of your Netlify CMS content collections to be consumed by frontend apps for better type support.

Features

  • Primitive types, e.g. string, number and boolean
  • Extract object widgets into own type interfaces
  • Single and nested lists
  • Multi-select and single option values
  • Optional fields
  • Unknown widgets resolve to any type
  • Relation fields

Installation

The package can be installed globally or as a devDependency using NPM or Yarn.

NPM:

npm install -g netlify-ts

# or

npm install -D netlify-ts

Yarn:

yarn global add netlify-ts

# or

yarn add -D netlify-ts

Usage

Method 1: CLI

The main method of usage is through the command-line. Having installed the package either globally or in project's devDependencies, simply call netlify-ts with a parameter pointing to your Netlify CMS admin config.yml file.

netlify-ts public/admin/config.yml

This generates by default a netlify-types.ts file in the project root containing types for your netlify content types.

Custom output location

You can also specify a custom output location by providing a second optional parameter. Omitting the filename outputs a file in the given directory with the default filename (netlify-types.ts).

netlify-ts public/admin/config.yml src/my-types.ts

Method 2: Programmatically

In case the CLI doesn't suit your project workflow or you need to invoke the type generation inside your code, the project exposes both a createNetlifyTypes and createNetlifyTypesAsync function that returns the generated type file as a string.

Config file

const fs = require("fs");
const { createNetlifyTypes } = require("netlify-ts");

function main() {
  const types = createNetlifyTypes("public/admin/config.yml");
  fs.writeFileSync("my-types.ts", types);
}

main();

Config object

const fs = require("fs");
const { createNetlifyTypes } = require("netlify-ts");

const cmsConfig = require("./config");

function main() {
  const types = createNetlifyTypes(cmsConfig);
  fs.writeFileSync("my-types.ts", types);
}

main();

License

MIT

About

Turn your Netlify CMS collections into TypeScript typings!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.5%
  • JavaScript 1.4%
  • Batchfile 0.1%