This repository contains the SvelteKit-powered Coversheet Generator used by USMA cadets to quickly produce assignment coversheets that conform to the June 2026 DAAW guidance. The app runs entirely in the browser, supports offline-friendly workflows, and can be deployed as a static site (e.g. GitHub Pages or CorpsTools static hosting).
- Guided form that auto-capitalizes fields, parses cadet rosters, and keeps course metadata in sync with
src/courses.js. - Signature workflow with draw, upload, clipboard, and saved signature options backed by
localStorage. - Instant download, print, and clipboard export (text or image) for the generated coversheet.
- Optional PDF prepending so the generated coversheet can be merged with an assignment document via
pdf-merger-js. - Built-in changelog & help content (
/info) that persists “new update” indicators per user. - Static build via
@sveltejs/adapter-staticwith a configurablebasepath for GitHub Pages-style hosting.
Prerequisites:
- Node.js 20+ (or the version used by your toolchain)
- Yarn Classic (v1)
Install dependencies:
yarn installStart a local dev server (defaults to http://localhost:5173):
yarn dev -- --openSvelteKit will reload automatically as you edit files in src/.
yarn dev– run the Vite-powered dev server.yarn build– produce a static build inbuild/.yarn preview– serve the production build locally.yarn ci– install dependencies with the lockfile (used in CI).yarn preci– clean the workspace by removingnode_modules/.yarn prepare– runsvelte-kit sync(automatic via package managers that callprepare).
src/routes/+page.svelte– main Coversheet Generator UI and logic.src/routes/info/+page.svelte– help, FAQ, and changelog view.src/routes/Coversheet.svelte– rendered coversheet that receives form updates.src/stores/persistentStore.js– lightweight helper that mirrors Svelte stores tolocalStorage.src/courses.js– deduplicated list of course codes/names used by the autocomplete.static/– static assets (manifest, icons, printable HTML template, advertisements).build/– output directory created byyarn build.
The src/courses.js file contains instructions (in comments at the top) for scraping the official course catalog. Follow those steps, replace the RAW_COURSES constant with the updated array, and commit the changes so the autocomplete reflects the latest offerings.
yarn buildoutputs a static site suitable for any static host. For GitHub Pages, the SvelteKit config automatically setspaths.base = '/csg'in non-dev builds—adjust this if you deploy under a different sub-path.yarn previewserves the contents ofbuild/so you can verify production output before publishing.- To host behind a CDN or reverse proxy, ensure requests for missing routes fall back to
index.htmlso SvelteKit can handle client-side routing.
User-specific data (saved signatures, changelog state, form settings) is stored locally in the browser via localStorage. The application does not send that data to a backend service; clearing browser storage resets the saved state.
Questions, feedback, or bug reports can be directed to korbin.deary@westpoint.edu, or by opening an issue in the repository where this code is hosted.