justapply 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shreyassuman2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# JustApply
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+See which job applications actually got a reply.
+
+JustApply turns your tracker exports into one clean dashboard: how many applications heard back, who replied, what's still waiting, and which days you applied. It also has a notebook for online assessments, so you can see which topics keep tripping you up.
+
+Everything runs on your own computer. Nothing is uploaded anywhere.
+
+## Run it
+
+You need [Node.js](https://nodejs.org) 18 or newer.
+
+```bash
+npx justapply
+```
+
+That starts JustApply at `http://localhost:4545` and opens it in your browser. Press `Ctrl+C` in the terminal to stop it.
+
+Then drop in your exports:
+
+- **Simplify:** Tracker → Export to CSV
+- **ApplyTwin:** export your applications as CSV
+
+You can load both; duplicates are merged. Load a newer export any time and JustApply shows what's new.
+
+Options: `npx justapply --port 4546` uses a different port, and `--no-open` skips opening the browser.
+
+## What it does
+
+- **Counts only real applications.** Saved, skipped and unfinished rows are left out.
+- **Merges duplicates** across both files using each posting's ID, so the same job is never counted twice.
+- **Funnel:** heard back, screens, offers, rejections, and what's still waiting or ghosted (no reply after 30 days).
+- **Heard back list, waiting clock, and an applying calendar.** Click a day to see what you applied to.
+- **Edit statuses** for updates your tracker doesn't have yet.
+- **OA notebook:** log each assessment's questions by topic and how they went, plus what went well, what went wrong and what to do next time. Weak topics rise to the top.
+- **Download your applications as a clean CSV.**
+
+## Your data
+
+Your data is saved in your browser, tied to `localhost:4545`, so keep using the same port. To keep it safe for the long term:
+
+- **Auto-save to a file** (Chrome, Edge, Arc, Brave): ⋯ menu → Auto-save to a file. Put it in iCloud Drive or Dropbox and it's backed up and synced.
+- **Backups:** ⋯ menu → Download backup, and Restore from backup on any machine.
+
+In Chrome you can also click the install icon in the address bar to give JustApply its own window and Dock icon. It works offline.
+
+## License
+
+MIT. Bundled libraries are listed in `vendor/LICENSES.md`.

package/bin/justapply.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+// JustApply launcher: serves the app from this package on your own computer and opens it in your browser.
+// No dependencies, nothing leaves your machine. Usage: npx justapply [--port 4545] [--no-open]
+'use strict';
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { exec } = require('child_process');
+
+const ROOT = path.join(__dirname, '..');
+const args = process.argv.slice(2);
+if (args.includes('-h') || args.includes('--help')) {
+  console.log('Usage: npx justapply [--port <number>] [--no-open]\n\nStarts JustApply at http://localhost:4545 and opens it in your browser.\nKeep the same port: your browser saves your data per address.');
+  process.exit(0);
+}
+const portArg = args.indexOf('--port');
+const PORT = portArg >= 0 ? Number(args[portArg + 1]) : Number(process.env.PORT) || 4545;
+const OPEN = !args.includes('--no-open');
+const URL_ = `http://localhost:${PORT}/`;
+
+const TYPES = {
+  '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json', '.webmanifest': 'application/manifest+json', '.svg': 'image/svg+xml',
+  '.png': 'image/png', '.ico': 'image/x-icon',
+};
+// Only these files are ever served.
+const ALLOWED = /^\/(index\.html|manifest\.webmanifest|sw\.js|icons\/[\w.-]+|vendor\/[\w.-]+)$/;
+
+const server = http.createServer((req, res) => {
+  let url;
+  try { url = new URL(req.url, URL_); } catch { res.writeHead(400).end(); return; }
+  let p = decodeURIComponent(url.pathname);
+  if (p === '/__justapply') { res.writeHead(200, { 'Content-Type': 'text/plain' }).end('justapply'); return; }
+  if (p === '/') p = '/index.html';
+  if (!ALLOWED.test(p)) { res.writeHead(404).end('Not found'); return; }
+  const file = path.join(ROOT, p);
+  if (!file.startsWith(ROOT + path.sep)) { res.writeHead(403).end(); return; }
+  fs.readFile(file, (err, data) => {
+    if (err) { res.writeHead(404).end('Not found'); return; }
+    res.writeHead(200, {
+      'Content-Type': TYPES[path.extname(file)] || 'application/octet-stream',
+      'Cache-Control': /index\.html|sw\.js/.test(p) ? 'no-cache' : 'public, max-age=3600',
+      'X-Content-Type-Options': 'nosniff',
+    });
+    res.end(data);
+  });
+});
+
+function openBrowser() {
+  if (!OPEN) return;
+  const cmd = process.platform === 'darwin' ? `open "${URL_}"` : process.platform === 'win32' ? `start "" "${URL_}"` : `xdg-open "${URL_}"`;
+  exec(cmd, () => {});
+}
+
+server.on('error', (err) => {
+  if (err.code !== 'EADDRINUSE') { console.error(err.message); process.exit(1); }
+  // Something already has the port. If it's JustApply (another terminal), just open it.
+  http.get(URL_ + '__justapply', (r) => {
+    let body = ''; r.on('data', c => body += c); r.on('end', () => {
+      if (body === 'justapply') { console.log(`JustApply is already running at ${URL_}`); openBrowser(); process.exit(0); }
+      portBusy();
+    });
+  }).on('error', portBusy);
+});
+function portBusy() {
+  console.error(`Port ${PORT} is in use by another program. Try: npx justapply --port 4546\n(Your data is saved per address, so keep using the same port afterwards.)`);
+  process.exit(1);
+}
+
+server.listen(PORT, '127.0.0.1', () => {
+  console.log(`\n  JustApply is running at ${URL_}\n\n  Your data stays in this browser on this computer. Press Ctrl+C to stop.\n`);
+  openBrowser();
+});
+process.on('SIGINT', () => { console.log('\nStopped.'); process.exit(0); });

package/icons/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><rect width="512" height="512" rx="112" fill="#f0efec"/><path d="M118 250l276-118-82 262-64-90z" fill="#141414"/><path d="M248 304l146-172-180 146z" fill="#3987e5"/><path d="M248 304l-4 82 50-52z" fill="#5b9bea"/></svg>

package/icons/maskable.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><rect width="512" height="512" fill="#f0efec"/><g transform="translate(256 256) scale(0.74) translate(-256 -256)"><path d="M118 250l276-118-82 262-64-90z" fill="#141414"/><path d="M248 304l146-172-180 146z" fill="#3987e5"/><path d="M248 304l-4 82 50-52z" fill="#5b9bea"/></g></svg>