@pixieset/versioning-js 1.0.13 → 2.0.1-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -84
- package/package.json +7 -5
package/README.md
CHANGED
|
@@ -1,87 +1,5 @@
|
|
|
1
1
|
# Pixieset Laravel versioning
|
|
2
|
-
This library is meant to augment the Laravel versioning approach created for Studio Manager. This repository contains
|
|
3
|
-
the front-end code for this project, and should be installed in conjunction with the backend work.
|
|
4
2
|
|
|
5
|
-
|
|
3
|
+
This library is an internal package meant for Pixieset application development.
|
|
6
4
|
|
|
7
|
-
|
|
8
|
-
## Contents
|
|
9
|
-
- [Pixieset Laravel versioning](#pixieset-laravel-versioning)
|
|
10
|
-
- [Contents](#contents)
|
|
11
|
-
- [Installation](#installation)
|
|
12
|
-
- [Usage](#usage)
|
|
13
|
-
- [Bundle development](#bundle-development)
|
|
14
|
-
- [Prerequisites](#prerequisites)
|
|
15
|
-
- [Installation](#installation-1)
|
|
16
|
-
- [Building](#building)
|
|
17
|
-
- [Pushing changes](#pushing-changes)
|
|
18
|
-
- [Footnotes](#footnotes)
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## Installation
|
|
22
|
-
|
|
23
|
-
**Prerequisites**:
|
|
24
|
-
|
|
25
|
-
Currently, this project supports Axios, Laravel, and Capacitor. You must also have a working Sentry integration in your front-end code already, and you must have installed the backend version checking code.
|
|
26
|
-
|
|
27
|
-
**Installation**:
|
|
28
|
-
|
|
29
|
-
The built front-end distribution code for this project is currently publicly available on packagist. Update your `package.json` file to include the following:
|
|
30
|
-
|
|
31
|
-
```json
|
|
32
|
-
{
|
|
33
|
-
"dependencies": {
|
|
34
|
-
"@pixieset/versioning-js": "^1.0"
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
Then run `yarn install` to install the package.
|
|
40
|
-
|
|
41
|
-
## Usage
|
|
42
|
-
|
|
43
|
-
For information on versioning usage, see [the Pixieset internal documentation](https://www.notion.so/pixieset/Studio-Manager-Resource-Versioning-WIP-d702c157a24e496e92f869eca2015c1b).
|
|
44
|
-
|
|
45
|
-
## Bundle development
|
|
46
|
-
|
|
47
|
-
This section is for developers who want to make changes to the bundle. It is assumed that you have a Laravel application that you are using to test the changes.
|
|
48
|
-
|
|
49
|
-
This package uses a Makefile to assist in building the package. See that file for the commands available, or run `make help` to see a list of available commands in that subfolder.
|
|
50
|
-
|
|
51
|
-
### Prerequisites
|
|
52
|
-
To build the frontend package, you will need to have the following installed:
|
|
53
|
-
- nodejs, version 18 or higher, with yarn globally.
|
|
54
|
-
- Follow the directions [here](https://classic.yarnpkg.com/lang/en/docs/cli/version/), as well, if you intend to commit.
|
|
55
|
-
|
|
56
|
-
### Installation
|
|
57
|
-
To make the frontend available locally, you can use the following steps:
|
|
58
|
-
|
|
59
|
-
1. Clone this repository into a directory of your Laravel application (if you haven't already done so). Preferably one that will not pollute your primary git source tree. We're going to use symlinks to connect it in a moment.
|
|
60
|
-
2. In the `versioning-js` portion of the package, invoke `yarn link`. This will make the package available for local linking and modification.
|
|
61
|
-
3. In your service provider where you are using the package (e.g. Studio Manager), invoke `yarn link @pixieset/versioning-js`. That will cause `yarn` to symlink the two, so you can make changes locally, and see them every time you run `make build`.
|
|
62
|
-
4. Run your local service provider front end `*-watch` task, to start hot-rebuilding your code based on file changes.
|
|
63
|
-
5. When done, run `yarn unlink @pixieset/versioning-js` within the service provider, to stop using linked code. Commit and tag your changes.
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
### Building
|
|
67
|
-
|
|
68
|
-
The frontend package contains build artifacts in the `dist` subfolder, which are compiled typescript files. These files are what you should be importing into your Vue components. Any changes you make to the typescript files in the `src` directory should be compiled into the `dist` directory when you run `make build`.
|
|
69
|
-
|
|
70
|
-
### Pushing changes
|
|
71
|
-
|
|
72
|
-
This project uses the [yarn version](https://classic.yarnpkg.com/lang/en/docs/cli/version/) tooling to publish changes. You should have set up your local environment as specified in the prerequisites.
|
|
73
|
-
|
|
74
|
-
First, set up your pull request, and confirm the changes you'd like to make. Use `yarn link` as described above, to ensure the changes actually work.
|
|
75
|
-
|
|
76
|
-
Once the pull request is merged, use `yarn version` as per the yarn documentation to create and publish a new front-end version. This should:
|
|
77
|
-
|
|
78
|
-
1. Create a new version number in package.json
|
|
79
|
-
2. Create a new git tag, with the same value.
|
|
80
|
-
|
|
81
|
-
Push the results of this, using `git push --tags`. This will trigger the pipeline to create a new build version automatically, and deploy it to NPM for installation.
|
|
82
|
-
|
|
83
|
-
Remember to unlink yarn before you try to install it.
|
|
84
|
-
|
|
85
|
-
## Footnotes
|
|
86
|
-
|
|
87
|
-
- For more information on the technical proposal, see [here](https://www.notion.so/pixieset/Technical-Proposal-SM-API-resource-versioning-41be2336e8f74ce5b1bdbaa04aa04a62?pm=c).
|
|
5
|
+
For information on versioning usage, see [the Pixieset documentation](https://www.notion.so/pixieset/Studio-Manager-Resource-Versioning-WIP-d702c157a24e496e92f869eca2015c1b).
|
package/package.json
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pixieset/versioning-js",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.1-alpha.1",
|
|
4
4
|
"description": "Front end support for Pixieset versioning",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
|
-
"url": "git@
|
|
8
|
+
"url": "git@gitlab.com:pixieset/packages/npm/versioning-js.git"
|
|
9
9
|
},
|
|
10
10
|
"author": "Aron Beal <aron.beal@pixieset.com>",
|
|
11
11
|
"license": "UNLICENSED",
|
|
12
12
|
"files": [
|
|
13
|
-
"dist"
|
|
13
|
+
"dist",
|
|
14
|
+
"README.md",
|
|
15
|
+
"LICENSE"
|
|
14
16
|
],
|
|
15
17
|
"devDependencies": {
|
|
16
18
|
"@types/axios": "^0.14",
|
|
@@ -48,7 +50,7 @@
|
|
|
48
50
|
"versioning"
|
|
49
51
|
],
|
|
50
52
|
"bugs": {
|
|
51
|
-
"url": "https://
|
|
53
|
+
"url": "https://gitlab.com/pixieset/packages/npm/versioning-js/-/issues"
|
|
52
54
|
},
|
|
53
|
-
"homepage": "https://
|
|
55
|
+
"homepage": "https://gitlab.com/pixieset/packages/npm/versioning-js"
|
|
54
56
|
}
|