Skip to content

Exposes the macOS APIs needed for generating Sketch files

License

Notifications You must be signed in to change notification settings

Lona/node-sketch-bridge

Repository files navigation

Node Sketch Bridge

This package exposes the macOS APIs needed for generating Sketch files. It relies on a node native module written in Obj-C.

npm install --save node-sketch-bridge

API

findFontName

const { findFontName } = require("node-sketch-bridge");

const fontName = findFontName({
  fontFamily: "Helvetica",
  fontStyle: "italic"
});

console.log(fontName); // "Helvetica-Oblique"

⚠️ Caveats:

  • If the fontFamily property is missing, or the requested font is not installed, it will fall back to the default system provided by the OS (usually, something from the San Francisco family). The specific font returned changes across macOS versions and for different font sizes.

createStringMeasurer

const { createStringMeasurer } = require("node-sketch-bridge");

const size = createStringMeasurer(
  [
    {
      content: "Hello",
      textStyles: {
        fontFamily: "Helvetica",
        fontSize: 16,
        fontWeight: "bold",
        fontStyle: "italic",
        lineHeight: 23,
        letterSpacing: 1,
        textDecoration: "underline",
        textAlign: "left"
      }
    }
  ],
  400
);

console.log(size); // "{ width: ..., height: ... }"

⚠️ Caveats:

  • When the lineHeight property is not specified, the default used by this function may be different from what Sketch uses by default for certain font families. This might result in a bounding box calculation that is different from what Sketch would display. For best results, it's advised to always specify the lineHeight explicitly.
  • Support for textTransform property is missing at the moment. When specified, the requested text transformation will not be taken into account when computing the bounding box.

makeImageDataFromURL

const { makeImageDataFromURL } = require("node-sketch-bridge");

const base64EncodedImage = makeImageDataFromURL("https://placekitten.com/200/300");

// The buffer will contain the PNG-encoded image of a kitten. Meow.
const imageBuffer = Buffer.from(base64EncodedImage, "base64");

Development

First, run npm install.

To develop in Xcode, you'll need to generate an Xcode project. The following worked for me on Mojave:

npm install --global node-gyp

node-gyp --python /usr/local/bin/python2 configure -- -f xcode

node-gyp build

Then, open build/binding.xcodeproj.

License

MIT

About

Exposes the macOS APIs needed for generating Sketch files

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •