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

Extension installation: Reference the composer config in config.yml for advanced devs

Open
#932 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Domain
documentation

Research direction

Read config.yml's composer settings and the linked “installing new extensions” documentation section first. Update that section to explain how advanced developers can use the composer configuration when loading development extensions, then verify the guidance matches the current configuration and extension workflow.

Written by the indexing model from the issue text.

Description

When attempting to develop locally, it is impossible to load a dev extension into Bolt without either setting it to a stable release (which is obviously not good for a new extension) or editing the composer settings in config.yml. Myself and others have hit a wall attempting to manually set minimum-stability:true in extensions/composer.json, only to have it constantly revert back to true.

I understand that the composer config vars in config.yml are not for everyone, and ideally should not be utilized most of the time. But they are there for a reason, and I think it's worth at least a mention in the installing new extensions section.

Dominant language
PHP
Stars
45
Forks
189
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

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 bolt/docs

All issues in bolt/docs

Similar issues

More PHP issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.