Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
a846a54
Changes to pull to include modules
MattJonesSiteglide Jul 10, 2026
74a11a8
Improved tidy up step. Includes promise to make sure the user knows w…
MattJonesSiteglide Jul 10, 2026
e700ede
Siteglide pull also pulls agent skills.
MattJonesSiteglide Jul 22, 2026
31f1e45
Polling starts by checking after 300ms, then after that incrementally…
MattJonesSiteglide Jul 22, 2026
2adf262
Download modules in parallel for better performance.
MattJonesSiteglide Jul 22, 2026
060c9b8
Quiter logs, but still informative.
MattJonesSiteglide Jul 22, 2026
1a9ad3f
Skip files with empty file paths https://feedback.siteglide.com/p/sit…
MattJonesSiteglide Jul 22, 2026
5a91c86
Experimental marketplace_builder to app and AI tools install, points …
MattJonesSiteglide Jul 22, 2026
bf6879b
Before adding MCP security - save
MattJonesSiteglide Jul 29, 2026
1709bf6
Adding gui interface.
MattJonesSiteglide Aug 6, 2026
9950e5f
pos-cli check command
MattJonesSiteglide Aug 6, 2026
609fc3c
pos-cli check command added
MattJonesSiteglide Aug 6, 2026
46f5505
Merge pull request #79 from Siteglide/Better-log-and-constants-GUI
MattJonesSiteglide Aug 6, 2026
542e323
Merge branch 'staging-mj' into Add-pos-cli-check-command
MattJonesSiteglide Aug 6, 2026
525d138
Merge pull request #80 from Siteglide/Add-pos-cli-check-command
MattJonesSiteglide Aug 6, 2026
953df51
Enhance env list
MattJonesSiteglide Aug 6, 2026
311c31f
Stop the rename marketplace_builder step.
MattJonesSiteglide Aug 6, 2026
69e7735
Zip has time
MattJonesSiteglide Aug 6, 2026
16631e0
Gate MCP setup on pull behind .siteglide/alpha.json credentials.
MattJonesSiteglide Aug 14, 2026
fb2a842
Don't ignore .md files, don't pull siteglide modules, treat module as…
MattJonesSiteglide Aug 14, 2026
e581c68
Allow deploy to deploy .md files; allow deploy to deploy files/folder…
MattJonesSiteglide Aug 17, 2026
80d5432
Rename for pull modules skip override.
MattJonesSiteglide Aug 17, 2026
ef385a7
Anticipate how the MCP will be installed, may change
MattJonesSiteglide Aug 17, 2026
f07cc2b
Remove the commit to skip // files. More trouble than it's worth.
MattJonesSiteglide Aug 17, 2026
bb60c16
Clarify that on 1st pull marketplace_builder should be used. Referenc…
MattJonesSiteglide Aug 18, 2026
edf8f82
Re-word module skip usage.
MattJonesSiteglide Aug 18, 2026
e80a3f1
1st see if published MCP, then secondarily check if access to private…
MattJonesSiteglide Aug 18, 2026
c97762b
Testing the dependencies between CLI and MCP. CLI should be independa…
MattJonesSiteglide Aug 18, 2026
6de7c67
In logs only, use "Siteglide AI skills" as an alias for "module_984"
MattJonesSiteglide Aug 18, 2026
857a2bb
m4a support
mattwalter91 Aug 20, 2026
4f2e2bb
generateManifest - Store file size
mattwalter91 Aug 20, 2026
50e1f69
m4a support
mattwalter91 Aug 20, 2026
fbb73cd
Readme - Fix doc links
mattwalter91 Aug 20, 2026
d9e0bec
GUI - Update wording in GUI link logs
mattwalter91 Aug 20, 2026
9c95284
Add semver dependency
MattJonesSiteglide Aug 20, 2026
00b453a
pull - Add more to ignored modules list
mattwalter91 Aug 20, 2026
0cc2545
Jest - Add package for testing
mattwalter91 Aug 20, 2026
e4e6b68
Merge branch 'staging-mj' of https://github.com/Siteglide/siteglide-c…
mattwalter91 Aug 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
.siteglide-config
.siteglide/alpha.json
node_modules
/marketplace_builder
.env
Expand All @@ -11,4 +12,6 @@ exported.json
/tmp
data-imported.json
/test_zip
.vscode
.vscode
gui/next/.svelte-kit
gui/next/node_modules
6 changes: 6 additions & 0 deletions .siteglide/alpha.json.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"token": "npm_xxxxxxxx",
"registry": "https://registry.npmjs.org/",
"tag": "alpha",
"package": "@siteglide/siteglide-mcp"
}
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

Siteglide CLI is a tool that enables you to work on your project from your local editor and has similar behaviours to that of using FTP, in that you can sync up and pull down changes from your website. You will be required to use some terminal commands to use this feature.

For features and setup instructions, see our help documentation [here](https://developers.siteglide.com/introducing-siteglide-cli)
For features and setup instructions, see our help documentation [here](https://docs.siteglide.com/articles/1541403-introduction-to-the-command-line-interface-cli)

Our changelog can be found [here](https://developers.siteglide.com/cli-changelog)
Our changelog can be found [here](https://docs.siteglide.com/articles/4471977-cli-changelog)

[![NPM version](https://img.shields.io/npm/v/@siteglide/siteglide-cli)](https://npmjs.org/package/@siteglide/siteglide-cli) [![NPM downloads](https://img.shields.io/npm/dt/@siteglide/siteglide-cli)](https://npmjs.org/package/@siteglide/siteglide-cli)
13 changes: 13 additions & 0 deletions gui/next/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
.DS_Store
node_modules
/.svelte-kit
/package
.env
.env.*
!.env.example
vite.config.js.timestamp-*
vite.config.ts.timestamp-*
/test-results/
/playwright-report/
/playwright/.cache/
/playwright/pos-cli-gui-qa/
127 changes: 127 additions & 0 deletions gui/next/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
pos-cli gui is an interface built to manage your platformOS instance and related data.

## Tech stack
- [SvelteKit](https://kit.svelte.dev) as front-end framework
- [Vite](https://vitejs.dev) as a development environment
- [Playwright](https://playwright.dev) for end-to-end testing

## Development
Prerequisites: [GIT](https://git-scm.com), [Node.js](https://nodejs.org/en), [pos-cli](https://github.com/mdyd-dev/pos-cli) installed and a [platformOS instance](https://documentation.platformos.com/get-started) configured.

1. Clone the whole pos-cli repository to an empty folder:

```bash
git clone https://github.com/mdyd-dev/pos-cli.git
```
2. Navigate to the `gui/next` subfolder:
```bash
cd gui/next
```
3. Install the dependencies:
```bash
npm install
```

### Run the development server
To run the dev server you just need to run the following command from `gui/next` directory
```bash
npm run dev
```

By default, it runs the server at [http://localhost:5173](http://localhost:5173) and you should be able to view the GUI under this URL. You need to leave the server running in the terminal.

To test things out though, you would like to **connect to an instance** to have some test data appearing in the GUI.

In a new terminal window, run `pos-cli gui serve [instance alias]` from the [authenticated directory](https://documentation.platformos.com/get-started/working-with-the-code-and-files/) where you have your test instance code. The same as you would normally use to run the GUI on daily development.

### Make your changes
You can edit the source code at `gui/next` and while the development server is running, it will refresh the changes in the browser automatically.

### Build the final code
Before publishing or testing the changes you will have to build the final package.

To do that run the following in `gui/next` directory:

```bash
npm run build
```

### Update and run the tests
When making changes and developing new functions, please make sure you will modify or add automated test scenarios placed in the `playwright` directory.

The one rule to follow here is that each test scenario should be completely independent. You cannot rely on the previous tests to prepare any data as each test can be ran in parallel in a random order. The initial data is seeded using the public repository: https://github.com/Platform-OS/pos-cli-gui-qa

#### Manually run tests

To manually run the tests, you would require a test instance that has the testing code deployed and test data seeded.

1. If not done previously, [install Playwright browsers](https://playwright.dev/docs/browsers)
```bash
npx playwright install --with-deps
```
2. Clone the test repository to an empty folder:
```bash
git clone https://github.com/Platform-OS/pos-cli-gui-qa.git
```
3. [Authenticate the directory](https://documentation.platformos.com/get-started/working-with-the-code-and-files/#authenticate-your-environment) to work with platformOS
4. Navigate to that directory and run the following to deploy the code:
```bash
pos-cli deploy <instance alias>
```
5. If the instance data was previously modified, you would have to clean the data to start fresh
```bash
pos-cli data clean <instance alias>
```
6. Seed the test data to the instance
```bash
pos-cli data import <instance alias> --path seed/data.zip --zip
```
7. Build the production-ready code
```bash
npm run build
```
8. Run the preview server
```bash
npm run preview
```

Finally, to run Playwright with an interface use the following command from `gui/next` directory:

```bash
npx playwright test --ui
```

This will run the Playwright interface, where you can run previously available test scenarios and see your changes when modifying the `.spec.js` test files.


#### Use a script to run tests

There is a Bash script prepared to run all the steps needed for automated testing. To use the script just run the following command from the `/gui/next` directory:

```bash
sh sh playwright/run.sh
```

Keep in mind that, by default, it uses an shared instance so if more than one person is running the tests, it might fail. You can change the instance it uses by editing the script.

The output would be a HTML report showing the tests results.


### Publish new version
When you are ready to publish the new GUI version:

1. Merge from `master` to make sure that you have the latest changes to the rest of the code
2. Increase the `pos-cli` version number by running the following from **the parent directory**:
```bash
npm version <minor|path>
```
3. Describe your changes in `CHANGELOG.md`
4. Commit and push your branch to GitHub, pass the review and merge to `master`.
5. Switch to `master` branch
```bash
git checkout master
```
6. Publish the new package to npm (requires you having the permissions):
```bash
npm publish
```
15 changes: 15 additions & 0 deletions gui/next/UPSTREAM.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# gui/next upstream

Vendored from `pos-cli` commit `b6c2948` (release 6.3.0).

Siteglide deltas vs upstream:

- Logs v1 poll interval: 7500ms (match `siteglide-cli logs`)
- Removed Logs v2 / Network routes and homepage tiles (discontinued upstream offering)
- Homepage and header include Database and Users; those views show a Siteglide Admin compatibility caution banner
- Branding: Siteglide titles, docs, portal, npm update check (`@siteglide/siteglide-cli`)

Smoke (global test install):

- Logs: pass
- Constants: pass
1 change: 1 addition & 0 deletions gui/next/build/_app/env.js
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
export const env={}
Loading