Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

docs(storage-resize-images): kit README's Multiple instances section fails in an installed project

Open Beginner friendly
#3,271 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
77/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
firebase, typescript
Domain
documentation

Research direction

Read the storage-resize-images kit README's Configuration and Multiple instances sections. Document the functions:kits:install and functions:kits:uninstall --instance workflow, including the installed layout and behavior described in the issue, and explain that an empty IS_ANIMATED= means false. Done when the README clearly covers creating and removing instances and the animation setting.

Written by the indexing model from the issue text.

Description

kits type: bug

storage-resize-images kit. Priority: low. Following the README's multiple-instance steps fails in an installed project, and two behaviours are undocumented.

Problems
  • The "Multiple instances" firebase.json fails in a project created by firebase functions:kits:install:
    Error: Could not detect runtime for functions at <project dir>
    
    What works is the layout the install writes: source at function-kits/storage-resize-images/source with its sourcePackage and predeploy entries, and one config-<id> directory per instance, each with a full .env (including FUNCTION_DEFAULT_REGION). Running the install a second time adds an instance, but always with id storage-resize-images and an empty .env. The README mentions neither route.
  • Removing one instance isn't documented. firebase functions:kits:uninstall --instance <id> removed that instance's function, Cloud Run service, Eventarc trigger, service account, config directory and firebase.json entry, and left the other instance running.
  • An empty IS_ANIMATED= drops animation. It deploys without warning, and a 5-frame gif and webp both come out as one frame. The Configuration table lists the default as true. The extension can't be installed with an empty value, and by reading its parser would also treat one as false, so this is a docs gap.
Code
Resolution

Rewrite "Multiple instances" around functions:kits:install and functions:kits:uninstall --instance, and note that an empty IS_ANIMATED= means false.

Dominant language
TypeScript
Stars
979
Forks
434
Avg merge
20h 44m
Merged PRs (30d)
17

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from firebase/extensions

All issues in firebase/extensions

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.