jonrohan / alfred-figma Goto Github PK

View Code? Open in Web Editor NEW

110.0 3.0 3.0 228 KB

Alfred workflow to quick link figma projects and files

License: MIT License

JavaScript 100.00%

alfred alfred-workflow alfred3-workflow alfred3 figma figma-api design design-tools

alfred-figma's Introduction

Figma Alfred 3 workflow

Alfred workflow to quick link Figma teams, projects and files

TODO:

Figma's API doesn't allow access to getting listings of draft files.
Figma's API doesn't allow access to get teams. This requires adding team ids to the workflow manually.
Files open in the desktop app, but teams and projects won't.

Installation

$ npm install --global alfred-figma

Requires Node.js 10+ and the Alfred Powerpack.

Configuration

There are a couple of requirements.

You need a Figma account and be part of a team.
Create a Personal Access Token so you can reach the API.
Create a .env file with your access token in the directory of the installed workflow.
- FIGMA_TOKEN=<personal-access-token>
- Alternatively add an environment variable for FIGMA_TOKEN
Add a team to your results with the figma add [teamurl] command.

Usage

The workflow lists results of 3 items teams, projects and files.

Teams

⏎ Open team page.
⌥ + ⏎ Remove team from workflow.
⌘ + ⏎ Open team page in web browser.

Projects

⏎ Open project page.
⌘ + ⏎ Open project page in web browser.

Files

⏎ Open file.
⌘ + Y OR shift Quicklook preview of the file.
⌥ + ⏎ Duplicate file to your drafts.
⌘ + ⏎ Open file in web browser.

Credits

alfy made by Sindre Sorhus is licensed by MIT

License

MIT © Jon Rohan

alfred-figma's People

Stargazers

Watchers

Forkers

eddaword hirajanwin vikingdadmedic

alfred-figma's Issues

Error: Alfred preferences not found at location /Users/username/Library/Preferences/com.runningwithcrayons.Alfred-Preferences-3.plist

I get this error on install, even though the Alfred .plist is in my Preferences folder.

Update to alfy v.0.8.0

There's an issue installing with npm, and someone from the Alfred repo team informed me that you're not using the latest version of alfy, which fixes this issue. See the conversation here:

SamVerschueren/alfred-link#20 (comment)

I'm still waiting for a proper .alfredworkflow file I can use to easily install this workflow (since I still can't get it to install via npm). So as a two-fold it would be nice if you can make sure this works with Alfred 4 and then maybe release an .alfredworkflow file so we can easily install. :) Thanks!

Install without npm. Use *.alfredworkflow file method.

Install without npm? Use *.alfredworkflow file method.

I can't get npm to work. It may be corporate laptop permission issue.

Figma add [teamurl] doesn't seem to work

So excited to use this! There might be an issue with the last step: It looks like anything written after the add part of the command will initiate a Google search instead of adding team.

(Also, any hints on where to find the team url? I'm not sure where to grab this from, and I'm sure other folks will have the same question.)

Add install case when users don't have any workflows

Tried to install this workflow via the cli npm install --global alfred-figma but kept getting this error:

> [email protected] postinstall /Users/misolori/.nvm/versions/node/v8.9.4/lib/node_modules/alfred-figma
> alfy-init

{ Error: Command failed: alfred-link
Error: Workflow directory `/Users/misolori/Library/Application Support/Alfred 3/Alfred.alfredpreferences/workflows` does not exist
    at pathExists.then.exists (/Users/misolori/.nvm/versions/node/v8.9.4/lib/node_modules/alfred-figma/node_modules/alfred-link/index.js:19:10)
    at <anonymous>


    at Promise.all.then.arr (/Users/misolori/.nvm/versions/node/v8.9.4/lib/node_modules/alfred-figma/node_modules/execa/index.js:236:11)
    at <anonymous>
    at process._tickCallback (internal/process/next_tick.js:188:7)
  code: 1,
  killed: false,
  stdout: '',
  stderr: 'Error: Workflow directory `/Users/misolori/Library/Application Support/Alfred 3/Alfred.alfredpreferences/workflows` does not exist\n    at pathExists.then.exists (/Users/misolori/.nvm/versions/node/v8.9.4/lib/node_modules/alfred-figma/node_modules/alfred-link/index.js:19:10)\n    at <anonymous>\n',
  failed: true,
  signal: null,
  cmd: 'alfred-link',
  timedOut: false }
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] postinstall: `alfy-init`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] postinstall script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/misolori/.npm/_logs/2018-10-25T15_46_44_571Z-debug.log

Turns out that if you don't have any workflows installed there is no workflows directory in Alfred.alfredpreferences. When installed, this case should be added to avoid these errors.