Ghost/ghost/admin-x-settings
Rishabh 3d6fb0d6b1 Added new package for admin-x settings
refs https://github.com/TryGhost/Team/issues/3151

- adds a new vite + typescript + storybook + TW package for setting up admin settings in react with base config that works with Ghost monorepo
- includes base components/design system for new settings UI
- adds eslint rule config to the package to match rest of Ghost codebase
- this is an experimental package as we figure out the best patterns for new admin packages in Ghost monorepo

Co-authored-by: Peter Zimon <zimo@ghost.org>
2023-05-16 12:23:24 +05:30
..
.storybook Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
public Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
src Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
test Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
.eslintrc.cjs Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
index.html Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
package.json Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
postcss.config.js Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
README.md Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
tailwind.config.js Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
tsconfig.json Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
tsconfig.node.json Added new package for admin-x settings 2023-05-16 12:23:24 +05:30
vite.config.ts Added new package for admin-x settings 2023-05-16 12:23:24 +05:30

Admin X Settings

Experimental re-write of Ghost Admin Settings in React

Development

Pre-requisites

  • Run yarn in Ghost monorepo root
  • Run yarn in this directory

Running the development version

Run yarn dev to start the development server to test/develop the settings standalone. This will generate a demo site from the index.html file which renders the app and makes it available on http://localhost:5173

Running inside Admin

To test/develop inside of Admin you can run yarn preview then in Ghost set your adminX value in config.local.json to http://localhost:4173/admin-x-settings.umd.js and load Admin as usual. Replace Ghost Admin's settings url with settings-x to load the new settings.

{
    ...
    "adminX": {
        "url": "http://localhost:4173/admin-x-settings.umd.js"
    }
}

yarn preview by itself only serves the library files, it's possible ro run yarn build --watch in a separate terminal tab to have auto-rebuild whilst developing.

Usage

Develop

This is a monorepo package.

Follow the instructions for the top-level repo.

  1. git clone this repo & cd into it as usual
  2. Run yarn to install top-level dependencies.

Test

  • yarn lint run just eslint
  • yarn test run lint and tests