Gscan claims `ghost-api` is deprecated but official docs still recommend it

Themes
1

Hi

I just updated my local ghost and gscan to latest versions

$ gscan -v
4.23.1
$ ghost -v
Ghost-CLI version: 1.18.2
Ghost version: 4.40.0

and then I run gscan to check if my theme still has no errors, and I got the following:

$ gscan content/themes/strider

Checking theme compatibility...

Your theme has 1 warning!
------

Warnings
--------
- Warning: package.json property "engines.ghost-api" is deprecated.
Files: package.json

Get more help at https://ghost.org/docs/api/handlebars-themes/
You can also check theme compatibility at https://gscan.ghost.org/

but the documentation still says using engines.ghost-api is ok.

The exact code in my package.json is

"engines": {
	"ghost": ">=4.0.0",
	"ghost-api": "v4"
},

What should I replace ghost-api with since it’s deprecated, but the official documentation still recommends it?

2

You can remove the ghost-api key from your package.json file. You will no longer receive the error.

3

Yes, I removed it and everything seems to be working as expected.
Just odd that gscan throws an error for something that the documentation says is ok :slight_smile:

4

I think it’s something that’ll be removed in the future, and this is just a case of the code moving faster than the documentation :upside_down_face: