Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

dropbox-trigger-netlify

Package Overview
Dependencies
Maintainers
1
Versions
20
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

dropbox-trigger-netlify

Deploy your Gatsby site whenever a specific Dropbox folder is updated.

  • 0.1.3
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
1
Maintainers
1
Weekly downloads
 
Created
Source

Dropbox Trigger Netlify

npm version

This is a companion package for gatsby-source-dropbox and enables automatic deploys of a Netlify hosted Gatsby site whenever there are files changes in a specific Dropbox folder.

This module is also implemented in gatsby-starter-dropbox-workflow


How it works

1. It watches your dropbox folder It expects your Dropbox app to have the following folder structure:

+-- Your Dropbox App Root Name
|   +-- _Update
|   +-- Content
|   |   +--Whatever Files you need.md
|   |   +--Whatever Folders you need

Whenever you drop the Content folder into the _Update folder the module will trigger a new deploy on Netlify. Make sure to do this only when the files in Content are uploaded to your Dropbox.

2. It notifies your once the build is done When Netlify finished building your site, the module will move the Content folder back to the root level. Whenever this happens, you know that your site was updated


Installation

The get the webhooks working, it is important to do the installation in the correct order.

1. Prepare your Gatsby site Add gatsby-source-dropbox to your Gatsby site.

2. Setup Netlify Functions Setup guide.

3. Install module in functions folder yarn add dropbox-trigger-netlify or npm install dropbox-trigger-netlify

Note: Modules used in a Netlify Function need to be installed in the src/functions folder.

4. Create function Create a new function called syncDropbox.js and add the following code:

const dropboxTriggerNetlify = require('dropbox-trigger-netlify')

exports.handler = async (event) => {
  try {

    const response = await dropboxTriggerNetlify.handleEvent(event, {
      dropboxToken: process.env.DROPBOX_TOKEN,
      buildHook: process.env.BUILD_HOOK,
    })

    return {
      statusCode: 200,
      body: response
    }
  } catch (err) {
    return { statusCode: 500, body: err.toString() }
  }
}

5. Create Dropbox App Go to Dropbox App Console and create a new app, choose your account type, only folder permission (recommended), choose a name and hit create.

6. Generate and Save Dropbox Token Scroll on app page to "OAuth 2" and click "Generate Token". Copy and save token to .env file in your projects root directory.

DROPBOX_TOKEN=Your-Dropbox-Token

7. Deploy Site to Netlify

8. Create a new Netlify Build Hook Go to your Netlify project to settings/deploys#build-hooks and add a new hook

9. Save Build Hook to .env file

DROPBOX_TOKEN=Your-Dropbox-Token
NETLIFY_BUILD_HOOK=Your-Hook-You-Just-Added

10. Create Netlify Deploy Notifications Got to your Netlify project to settings/deploys#deploy-notifications and add an outgoing webhook for succeeded and failed builds pointing to [you-site-url]/.netlify/functions/syncDropbox

11. Add Environment Variables to Netlify Add the environment variables from your .env file to netlify at settings/deploys#environment-variables

12. Add Webhook to Dropbox App Go to Dropbox App Console to you app and add a webhook pointing to you NETLIFY_BUILD_HOOK

Keywords

FAQs

Package last updated on 13 Jun 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc