https://github.com/itemconsulting/xp-part-finder
Developer utilities for working with xp components
https://github.com/itemconsulting/xp-part-finder
Last synced: 4 months ago
JSON representation
Developer utilities for working with xp components
- Host: GitHub
- URL: https://github.com/itemconsulting/xp-part-finder
- Owner: ItemConsulting
- License: mit
- Created: 2024-04-04T11:16:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-07T14:37:58.000Z (5 months ago)
- Last Synced: 2025-02-07T15:32:08.309Z (5 months ago)
- Language: TypeScript
- Homepage:
- Size: 504 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Part Finder
When you are working on an XP-part – you might want to know all the content where it's being used. This app provides an
admin tool that lists usage of your components (parts, layouts, pages) to help you with testing and configuration.
[](https://repo.itemtest.no/#/releases/no/item/xp-part-finder)
## Setup
Install npm-dependencies
```bash
npm install
```
To prepare the Storybook-environment you need to create a _.env_ file. The easiest way is to copy over the existing
_.env_example_ file.
```bash
cp .env_example .env
```
> [!IMPORTANT]
> Make sure `STORYBOOK_SERVER_URL` in _.env_ matches a valid service path in **your** local XP setup.
## Running storybook
To make development easier and quicker, pages, layouts, parts and Freemarker-macros have Storybook-stories that let us
get immediate feedback when developing.
To be able to run Storybook locally you need to install [xp-storybook](https://github.com/ItemConsulting/xp-storybook)
in your local sandbox. When it is installed, you can run storybook locally with the following command:
```bash
npm run storybook
```
## Building
To build the project, run the following command
```bash
enonic project build
```
You will find the jar-file at _./build/libs/item.jar_
## Deploying locally
To deploy to a local sandbox, run the following command
```bash
enonic project deploy
```
## Deploy to Maven
```bash
./gradlew publish -P com.enonic.xp.app.production=true
```