# netlify-cms-backend-git-gateway

> Git Gateway backend for Netlify CMS

Latest version **2.13.1** (published 2022-03-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install netlify-cms-backend-git-gateway
pnpm add netlify-cms-backend-git-gateway
yarn add netlify-cms-backend-git-gateway
bun add netlify-cms-backend-git-gateway
```

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: esm support; no vulnerabilities; high maintenance score; popular repo.

Warnings: low downloads; no types.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 2.13.1 |
| Published | 2022-03-08 |
| First published | 2018-07-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 848.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 19404 |
| Maintainers | seanroberts, dustincrogers, skn0tt, mikewen, dengeist, biilmann, marcus.netlify, ehmicky, erezro, jgantunes, eduardoboucas, netlify-bot, nasiba, zachleat, ascorbic, erquhart |
| Keywords | netlify, netlify-cms, backend, git-gateway, gateway |

## Links

- npm: https://www.npmjs.com/package/netlify-cms-backend-git-gateway
- Repository: https://github.com/netlify/netlify-cms.git#master
- Homepage: https://github.com/netlify/netlify-cms/tree/master#readme
- Issues: https://github.com/netlify/netlify-cms/issues
- npm.io page: https://npm.io/package/netlify-cms-backend-git-gateway

## Dependencies (4)

- [ini](https://npm.io/package/ini.md) ^2.0.0
- [gotrue-js](https://npm.io/package/gotrue-js.md) ^0.9.24
- [minimatch](https://npm.io/package/minimatch.md) ^3.0.4
- [jwt-decode](https://npm.io/package/jwt-decode.md) ^3.0.0

## Recent versions

- 2.13.1 (latest) — 2022-03-08
- 2.12.0-beta.0 (beta) — 2021-05-03
- 2.13.0 — 2021-12-28
- 2.12.2 — 2021-06-01
- 2.12.1 — 2021-05-31
- 2.12.0 — 2021-05-04
- 2.11.11 — 2021-02-25
- 2.11.10 — 2021-02-23
- 2.11.9 — 2021-02-10
- 2.11.8 — 2020-12-15
- 2.11.7 — 2020-12-06
- 2.11.6 — 2020-10-12
- 2.11.5 — 2020-09-20
- 2.11.4 — 2020-09-15
- 2.11.3 — 2020-09-08
- … 53 more at https://npm.io/package/netlify-cms-backend-git-gateway/versions

## README

# Git Gateway

Netlify's [gateway](https://github.com/netlify/git-gateway) to hosted git APIs.

## Code structure

`Implementation` for [File Management System API](https://github.com/netlify/netlify-cms/tree/master/packages/netlify-cms-lib-util/README.md) based on `Api`.

`Api` and `Implementation` from backend-[github](https://github.com/netlify/netlify-cms/tree/master/packages/netlify-cms-backend-github/README.md)/[gitlab](https://github.com/netlify/netlify-cms/tree/master/packages/netlify-cms-backend-gitlab/README.md)/[bitbacket](https://github.com/netlify/netlify-cms/tree/master/packages/netlify-cms-backend-bitbacket/README.md) extended with Netlify-specific `LargeMedia(LFS)` and `JWT` auth.

`AuthenticationPage` - uses [lib-auth](https://github.com/netlify/netlify-cms/tree/master/packages/netlify-cms-lib-auth/README.md) and implements Netlify Identity authentication flow.

Look at tests or types for more info.

## Debugging

When debugging the CMS with Git Gateway you must:

1. Have a Netlify site with [Git Gateway](https://docs.netlify.com/visitor-access/git-gateway/) and [Netlify Identity](https://docs.netlify.com/visitor-access/identity/) enabled. An easy way to create such a site is to use a [template](https://www.netlifycms.org/docs/start-with-a-template/), for example the [Gatsby template](https://app.netlify.com/start/deploy?repository=https://github.com/AustinGreen/gatsby-starter-netlify-cms&stack=cms)
2. Tell the CMS the URL of your Netlify site using a local storage item. To do so:

    1. Open `http://localhost:8080/` in the browser
    2. Write the below command and press enter: `localStorage.setItem('netlifySiteURL', 'https://yourwebsiteurl.netlify.app/')`
    3. To be sure, you can run this command as well: `localStorage.getItem('netlifySiteURL')`
    4. Refresh the page
    5. You should be able to log in via your Netlify Identity email/password

---
_Source: https://npm.io/package/netlify-cms-backend-git-gateway · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._