firebase-functions-typescript-starter - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #llm #golang #rust #deep-learning #linux #macos #cli #awesome-list #security #ios #open-source

firebase-functions-typescript-starter

(★ 103)

Create & test Firebase Cloud Functions in TypeScript

파일 탐색기

최종 버전 다운로드 (.zip)

- - analysis.function.ts
  - functions-config.ts
  - index.ts
- - analisys.spec.ts
  - average.spec.ts
- .eslintrc.json
- .mocharc.json
- package-lock.json
- package.json
- rollup.config.js
- tsconfig.json
.firebaserc
.gitignore
CHANGELOG.md
firebase.json
LICENSE
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/robisim74/firebase-functions-typescript-starter

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd firebase-functions-typescript-starter

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm test

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm run build:dev

배포용으로 코드를 최적화해서 빌드 파일을 생성합니다.

npm run serve:dev

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm run build

배포용으로 코드를 최적화해서 빌드 파일을 생성합니다.

npm run deploy

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Firebase Functions TypeScript starter

>Create & test Firebase Cloud Functions in TypeScript

This starter allows you to create & test **Firebase Cloud Functions** in _TypeScript_.

Get the [Changelog](https://github.com/robisim74/firebase-functions-typescript-starter/blob/master/CHANGELOG.md).

## Contents
* [1 Project structure](#1)
* [2 Customizing](#2)
* [3 Testing](#3)
* [4 Building](#4)
* [5 Publishing](#5)
* [6 What it is important to know](#6)

## <a name="1"></a>1 Project structure
- **functions**:
    - **src** folder for the Functions
        - **index.ts** entry point for all your Firebase Functions
    - **tests** folder for the _Mocha_ tests
    - **package.json** _npm_ options
    - **rollup.config.js** _Rollup_ configuration for building the ES bundle
    - **tsconfig.json** _TypeScript_ compiler options
    - **.mocharc.json** _Mocha_ options
    - **.eslintrc.json** _ESLint_ configuration
- **.firebaserc**: Firebase projects

## <a name="2"></a>2 Customizing
1. Update [Firebase CLI](https://github.com/firebase/firebase-tools).

2. Update `.firebaserc` with your `project-id`.

3. Add your Firebase Functions to `index.ts` and create different files for each one.

4. Update in `rollup.config.js` file external dependencies with those that actually you use to build the ES bundle.

5. Create unit tests in `tests` folder.

## <a name="3"></a>3 Testing
The following command runs unit tests using _Mocha_ that are in the `tests` folder: 
```Shell
npm test 
```

## <a name="4"></a>4 Building
#### Development
Start _tsc_ compiler with _watch_ option:
```Shell
npm run build:dev
```

Start the emulator _firebase emulators:start --only functions_
```Shell
npm run serve:dev
```

For the other supported emulators, please refer to the official documentation: [
Run Functions Locally](https://firebase.google.com/docs/functions/local-emulator)

#### Production
The following command:
```Shell
npm run build
```
creates `lib` folder with the file of distribution:
```
└── functions
    └──lib
        └── index.js
```

## <a name="5"></a>5 Publishing
```Shell
npm run deploy
```

## <a name="6"></a>6 What it is important to know
1. _Node.js_

The engine in `package.json` is set to _Node.js 16_

2. ES Modules

_Node.js 16_ supports ES Modules: so you have `"type": "module"` in `package.json`, `format: 'es'` in `rollup.config.js` and `tsconfig.js` used by _tsc_ compiler targets ES2021 with ES2020 modules

3. Bundling with _Rollup_

_Firebase Cloud Functions_ do not require the deployment of a single bundle. In any case the building with _Rollup_ offers some advantages:
    * _Tree shaking_ of unused code
    * No request for other files at runtime

## License
MIT