shared-hosting-sync 0.1.1 → 0.1.3
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/CHANGELOG.md +8 -0
- package/package.json +1 -1
- package/src/cli.js +31 -0
- package/src/ui/index.html +23 -1
- package/src/ui/style.css +12 -0
- package/src/ui/ui.js +10 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.3 — 27 October 2026
|
|
4
|
+
|
|
5
|
+
- Add a styled console startup banner with app version and creator contact details,
|
|
6
|
+
terminal-aware colors, and a compact layout for narrow terminals.
|
|
7
|
+
- Add a dedicated dashboard About & Help section with creator details, the running
|
|
8
|
+
version, setup guidance, troubleshooting, and documentation links.
|
|
9
|
+
- Keep unfinished project setup intact while About & Help is open.
|
|
10
|
+
|
|
3
11
|
## 0.1.1 — 26 October 2026
|
|
4
12
|
|
|
5
13
|
- Fix dashboard “Edit setup” so saved projects can change their local folder,
|
package/package.json
CHANGED
package/src/cli.js
CHANGED
|
@@ -494,9 +494,40 @@ ${C.b('other')}
|
|
|
494
494
|
}
|
|
495
495
|
}
|
|
496
496
|
|
|
497
|
+
function printBanner() {
|
|
498
|
+
const color = process.stdout.isTTY && !('NO_COLOR' in process.env)
|
|
499
|
+
const paint = (style, value) => color ? style(value) : value
|
|
500
|
+
const lines = [
|
|
501
|
+
['DEVSYNC', C.b],
|
|
502
|
+
[`Shared hosting sync / v${version}`, C.c],
|
|
503
|
+
['', C.dim],
|
|
504
|
+
['Local projects → your hosting', C.dim],
|
|
505
|
+
['', C.dim],
|
|
506
|
+
['Created by Rogers Kitamirike', C.b],
|
|
507
|
+
['Ugandan developer', C.dim],
|
|
508
|
+
['', C.dim],
|
|
509
|
+
['Phone +256757035774', C.c],
|
|
510
|
+
['Email kitarogz@gmail.com', C.c]
|
|
511
|
+
]
|
|
512
|
+
const width = 46
|
|
513
|
+
console.log()
|
|
514
|
+
if (process.stdout.columns && process.stdout.columns < width + 6) {
|
|
515
|
+
for (const [line, style] of lines) console.log(paint(style, line))
|
|
516
|
+
} else {
|
|
517
|
+
const border = (line) => paint(C.c, line)
|
|
518
|
+
console.log(border(' ╭' + '─'.repeat(width + 2) + '╮'))
|
|
519
|
+
for (const [line, style] of lines) {
|
|
520
|
+
console.log(border(' │ ') + paint(style, line) + ' '.repeat(width - line.length) + border(' │'))
|
|
521
|
+
}
|
|
522
|
+
console.log(border(' ╰' + '─'.repeat(width + 2) + '╯'))
|
|
523
|
+
}
|
|
524
|
+
console.log()
|
|
525
|
+
}
|
|
526
|
+
|
|
497
527
|
async function main() {
|
|
498
528
|
try {
|
|
499
529
|
if (flags.version || cmd === 'version') { console.log(`${name} ${version}`); return }
|
|
530
|
+
printBanner()
|
|
500
531
|
if (flags.help || cmd === 'help') return COMMANDS.help()
|
|
501
532
|
if (!cmd) return flags.sync ? await COMMANDS.sync() : await COMMANDS.plan()
|
|
502
533
|
if (!Object.hasOwn(COMMANDS, cmd)) throw new Error(`unknown command: ${cmd}. Run devsync help`)
|
package/src/ui/index.html
CHANGED
|
@@ -10,8 +10,30 @@
|
|
|
10
10
|
<body>
|
|
11
11
|
<header class="topbar"><a class="brand" href="/">shared-hosting-sync<span class="brand-dot"></span></a><span class="topbar-note">Your projects. Your hosting.</span><span class="connection-pill" id="serverStatus">Connecting…</span></header>
|
|
12
12
|
<div class="layout">
|
|
13
|
-
<aside class="sidebar"><div class="sidebar-heading">PROJECTS <span id="projectCount">0</span></div><div id="projectList"></div><button class="add-project" id="addProject">+ Add project</button><div class="sidebar-note">Runs on this computer.<br>Hosting credentials stay local.</div></aside>
|
|
13
|
+
<aside class="sidebar"><div class="sidebar-heading">PROJECTS <span id="projectCount">0</span></div><div id="projectList"></div><button class="add-project" id="addProject">+ Add project</button><button class="about-help-button secondary" id="openAboutHelp" aria-haspopup="dialog">About & Help</button><div class="sidebar-note">Runs on this computer.<br>Hosting credentials stay local.</div></aside>
|
|
14
14
|
<main id="pane" class="pane" aria-live="polite"><div class="empty">Loading your projects…</div></main>
|
|
15
15
|
</div>
|
|
16
|
+
<dialog id="aboutHelpDialog" class="about-help-dialog" aria-labelledby="aboutHelpTitle">
|
|
17
|
+
<div class="about-help-heading"><div><p class="eyebrow">DEVSYNC</p><h1 id="aboutHelpTitle">About & Help</h1></div><form method="dialog"><button class="secondary" aria-label="Close About and Help" autofocus>Close</button></form></div>
|
|
18
|
+
<p class="sub">A simpler way to move local projects to your hosting.</p>
|
|
19
|
+
<nav class="help-links" aria-label="About and help sections"><a href="#aboutCreator">About</a><a href="#gettingStarted">Getting started</a><a href="#commonQuestions">Common questions</a></nav>
|
|
20
|
+
<section class="summary-card" id="aboutCreator" aria-labelledby="creatorTitle">
|
|
21
|
+
<p class="eyebrow">MEET THE CREATOR</p><h2 id="creatorTitle">Rogers Kitamirike</h2><p class="muted">Ugandan developer · Creator of DevSync</p>
|
|
22
|
+
<dl class="review"><dt>Phone</dt><dd><a href="tel:+256757035774">+256757035774</a></dd><dt>Email</dt><dd><a href="mailto:kitarogz@gmail.com">kitarogz@gmail.com</a></dd><dt>Package</dt><dd>shared-hosting-sync <span id="aboutVersion"></span></dd></dl>
|
|
23
|
+
<div class="help-links"><a href="https://github.com/kitaroghope/shared-hosting-sync#readme" target="_blank" rel="noopener noreferrer">Documentation ↗</a><a href="https://github.com/kitaroghope/shared-hosting-sync/issues" target="_blank" rel="noopener noreferrer">Report an issue ↗</a></div>
|
|
24
|
+
</section>
|
|
25
|
+
<section class="summary-card" id="gettingStarted" aria-labelledby="gettingStartedTitle"><h2 id="gettingStartedTitle">Get your first project online</h2>
|
|
26
|
+
<ol class="help-steps"><li><strong>Add your local folder.</strong> Choose Add project, then select the folder to upload. For a built website, choose its build or dist folder.</li><li><strong>Connect your hosting.</strong> Enter your FTP, FTPS, or SFTP details, or load DEVSYNC_* settings from the folder’s .env. Test the connection to continue.</li><li><strong>Choose the server folder.</strong> Browse to the destination, select Use server folder, review, and save.</li><li><strong>Preview, then deploy.</strong> Preview uploads shows the planned files. Deploy uploads all eligible files; Sync uploads changed files. Watch follows subsequent saves while DevSync runs.</li></ol>
|
|
27
|
+
</section>
|
|
28
|
+
<section class="summary-card" id="commonQuestions" aria-labelledby="commonQuestionsTitle"><h2 id="commonQuestionsTitle">Common questions</h2>
|
|
29
|
+
<details><summary>How do I change a project’s local folder or hosting settings?</summary><p>Open the saved project and choose Edit setup. Change or browse for the local folder, review your hosting settings and destination, then save. Stop any active watch or upload before editing.</p></details>
|
|
30
|
+
<details><summary>Why can’t I connect to my hosting?</summary><p>Confirm the host, protocol, port, username, and credentials with your hosting provider. FTP and FTPS usually use port 21; SFTP usually uses 22. If your ISP blocks port 21, ask your host whether SFTP or an alternative port is available. The server must support the protocol and port you choose.</p></details>
|
|
31
|
+
<details><summary>Why are my changes not uploading?</summary><p>Check the selected local folder and server destination. Use Preview uploads to see which files are included or excluded, check whether Preview only is enabled, and open the Activity log for errors. Watch requires DevSync to remain running.</p></details>
|
|
32
|
+
<details><summary>Which settings take priority?</summary><p>Settings in the selected folder’s .env take priority over .devsync.env and saved settings. If an edit appears to revert, check those files. DevSync does not rewrite your application’s environment files.</p></details>
|
|
33
|
+
<details><summary>Are credentials and server files protected?</summary><p>Saved credentials are encrypted on this computer. Environment files and other protected files are excluded from deployment. Local deletions are never mirrored to the server. Preview uploads before deploying to confirm your destination and file list.</p></details>
|
|
34
|
+
<details><summary>Can I use DevSync from a terminal?</summary><p>Run <code>devsync help</code> for commands, <code>devsync ui</code> for this dashboard, or <code>devsync doctor</code> to check your local installation. The <code>shared-hosting-sync</code> command works as an alias.</p></details>
|
|
35
|
+
</section>
|
|
36
|
+
<p class="help about-help-footer">Need a hand? Email the creator or report an issue with the error message and your DevSync version. Keep passwords and private keys out of reports.</p>
|
|
37
|
+
</dialog>
|
|
16
38
|
</body>
|
|
17
39
|
</html>
|
package/src/ui/style.css
CHANGED
|
@@ -127,3 +127,15 @@ h1{font-size:25px}
|
|
|
127
127
|
.operation-metrics>div{padding:14px;background:#10161f;border:1px solid var(--line);border-radius:8px}.operation-metrics strong{display:block;font-size:21px}.operation-metrics span{font-size:12px;color:var(--muted)}
|
|
128
128
|
.plan-table-wrap{max-height:300px;overflow:auto;margin:14px 0}.plan-table{width:100%;border-collapse:collapse;font-size:12px;text-align:left}.plan-table th,.plan-table td{padding:10px;border-bottom:1px solid var(--line);word-break:break-word}.plan-table th{color:var(--muted);position:sticky;top:0;background:var(--panel)}.plan-table td:last-child{white-space:nowrap}
|
|
129
129
|
.file-list{font:12px/1.7 ui-monospace,monospace;max-height:220px;overflow:auto;padding:0 0 0 20px;word-break:break-word}.operation-log{font:12px/1.8 ui-monospace,monospace;max-height:260px;overflow:auto;list-style:none;padding:12px;background:#0e131c;border-radius:6px}.operation-log time{color:var(--muted)}.log-error{color:var(--danger)}.log-success{color:var(--accent)}
|
|
130
|
+
|
|
131
|
+
.about-help-button{width:100%;margin-top:24px;text-align:left}
|
|
132
|
+
.about-help-dialog{color:var(--text);background:var(--bg);border:1px solid var(--line);border-radius:16px;width:min(820px,calc(100% - 32px));max-height:88vh;padding:30px;overflow:auto;scroll-behavior:smooth}
|
|
133
|
+
.about-help-dialog::backdrop{background:rgba(0,0,0,.72)}
|
|
134
|
+
.about-help-heading{display:flex;justify-content:space-between;align-items:flex-start;gap:16px}
|
|
135
|
+
.about-help-heading form{margin:0}.about-help-heading h1{margin-bottom:10px}
|
|
136
|
+
.help-links{display:flex;flex-wrap:wrap;gap:12px 22px}
|
|
137
|
+
.help-links a{text-underline-offset:4px}
|
|
138
|
+
.help-steps{padding-left:22px;margin-bottom:0}.help-steps li{padding-left:6px;margin:14px 0;color:var(--muted)}.help-steps strong{color:var(--text)}
|
|
139
|
+
.about-help-dialog section{scroll-margin-top:16px}.about-help-dialog details p{margin:12px 0 0;color:var(--muted)}
|
|
140
|
+
.about-help-dialog code{color:var(--accent);overflow-wrap:anywhere}.about-help-footer{margin:24px 0 0}
|
|
141
|
+
@media(max-width:580px){.about-help-dialog{padding:20px;max-height:92vh}.about-help-dialog .summary-card{padding:18px}.about-help-button{margin-top:10px}.about-help-dialog .review{margin:18px 0}}
|
package/src/ui/ui.js
CHANGED
|
@@ -274,6 +274,16 @@ async function openProject(id) {
|
|
|
274
274
|
setBusy(state.busy)
|
|
275
275
|
}
|
|
276
276
|
|
|
277
|
+
$('#openAboutHelp').onclick = async () => {
|
|
278
|
+
const dialog = $('#aboutHelpDialog')
|
|
279
|
+
if (dialog.open) return
|
|
280
|
+
dialog.showModal()
|
|
281
|
+
try {
|
|
282
|
+
const health = await api('GET', '/api/health')
|
|
283
|
+
$('#aboutVersion').textContent = `· v${health.version}`
|
|
284
|
+
} catch { $('#aboutVersion').textContent = '· Version unavailable' }
|
|
285
|
+
}
|
|
286
|
+
|
|
277
287
|
$('#addProject').onclick = () => act(startNew)
|
|
278
288
|
;(async () => {
|
|
279
289
|
try {
|