Desktop: 
Mobile: 
Tested on 2026-10-03 with Lighthouse in Microsoft Edge 154.0.4258.48
Your resume, your device — private by design.
- Private: Your personal data never leaves your device — no accounts, no uploads.
- Offline-ready: Works without internet once installed as a PWA via Service Worker.
- Print-perfect: Exports A4-accurate PDFs with Gothic or Mincho Japanese font choice.
- Agent-ready: The input form is annotated for WebMCP, so AI agents in WebMCP-capable browsers can fill it in.
ShigotoForm is a client-side PWA for creating Japanese-style resumes. All data is stored in your browser's IndexedDB and never transmitted anywhere. Fill in the form, preview in A4 layout, and download a high-resolution PDF — no account, no backend, no privacy risk.
- Cloud exposure: Most resume tools upload your data to a server — ShigotoForm runs entirely client-side; nothing is ever transmitted.
- No Japanese support: Western PDF tools lack the Japanese resume（履歴書）layout — ShigotoForm renders it with proper Japanese font support.
- Paywalled PDF export: Most tools charge for PDF output — ShigotoForm generates PDFs locally using html2pdf.js, for free.
- Data loss on device switch: Switching devices without a backup means losing your data — use JSON export/import to back up and restore anywhere.
- Client-side only: No data transmission to external servers
- IndexedDB storage: All resume data is stored in your browser's IndexedDB (via Dexie) and stays on your device
- Privacy-first: Designed with personal data protection in mind
- HTTPS enforced: The Netlify deployment sends a
Strict-Transport-Securityheader (see public/_headers) - Future enhancement: Local encryption planned for additional security
# Development with hot reload
docker compose up dev
# Production build (nginx, http://localhost)
docker compose up prod
# or
docker build -t shigotoform .
docker run -p 80:80 shigotoformgit clone https://github.com/hidao80/ShigotoForm.git
cd ShigotoForm
bun install
bun devThis will start the development server on https://localhost:5173.
bun run build # Type-check (tsc) → Vite build → dist/
bun run preview # Serve the built dist/ locally
bun run lint # Biome check + tsc --noEmit
bun run format # Biome auto-format
bun run test # Vitest: unit (jsdom) + E2E (Chromium via Playwright)
bun run test:unit # Unit tests only
bun run test:e2e # E2E tests only (first run: bunx playwright install chromium)
bun run coverage # All tests with a V8 coverage report (text, coverage/index.html, coverage/lcov.info)
bun run screenshot # Capture screenshots across all viewports- Date: Select the date the résumé is written from the calendar. (required)
- Furigana and Full Name: Enter your full name and the furigana (in hiragana) is auto-filled to some extent. You can edit it afterwards. (required)
- Date of Birth: Select a date from the calendar or type it in directly. Your age is shown automatically. (required)
- Sex: Free text. You can leave it blank.
- Postal Code and Address: The postal code is 7 digits (a hyphen is allowed). (both required)
- Phone Number and Email Address: Enter the phone number in half-width digits (e.g. 03-1234-5678) and the email address in a valid format. Both can be left blank.
- Other contact address: Only if you want to be contacted somewhere other than your current address, open the contact section and enter the address and phone number.
- Education/Work History: Enter the start and end month (leave the end month blank if you are still there), the company or school, the position or department, and a description, in a list format. Add a row with "+" and remove it with "Delete".
- Qualifications/Licenses: Enter the month and the name in a list format, and choose whether it was "acquired" or "passed". You can add or remove rows.
Drag the handle (⋮⋮) at the right end of a row in "Education/Work History" or "Qualifications/Licenses" to move it up or down (mouse and touch).
With the keyboard, focus the handle, press Space to pick the row up, move it with the up/down arrow keys and press Space to drop it. Esc cancels.
The new order is what gets saved, exported, previewed and written to the PDF.
You can export the entered resume information to a JSON file or import a previously exported JSON file.
Open the menu from the hamburger button at the top right and click the "Export" or "Import" button.
When exporting, a JSON file will be downloaded.
When importing, select a JSON file from your device and the input screen will be updated immediately. Your current input is replaced by the imported content.
The imported file is validated first. If it is not valid JSON or its contents have the wrong format, an error message listing the problem fields (up to 5, in Japanese) is shown and your current data is left unchanged.
Required fields (date, furigana, name, birth date, postal code, address) and the format of postal code, phone numbers and e-mail address are validated with Zod.
- Fields are checked when you leave them, and an error already on screen disappears as soon as you fix it.
- If the form has errors, "Show résumé" is blocked: a warning lists the problems and the cursor moves to the first invalid field.
- Export still works with errors (a warning is shown), so you can back up a half-filled résumé. Auto-save is not affected either.
The content entered on the input screen can be previewed in A4 paper size.
Click "Show resume" in the menu to open the preview (available once your saved data has been restored, and blocked while the form has errors).
You can select either Gothic or Mincho font.
Click "Download Resume PDF" at the bottom of the preview to save as PDF.
Everything you type is saved to IndexedDB in your browser automatically, including added, removed or reordered education/work and license rows. Nothing is sent to a server. Reopening the app restores your last input.
Switch between light and dark themes with the "Dark mode" toggle in the menu. Your choice is remembered on your device (in localStorage, as it is a single small setting rather than resume data).
Click "Delete input" in the menu to clear the form and all saved data (a confirmation dialog is shown first). This cannot be undone, so export first if you may need it.
The input form declares a WebMCP tool (fill-resume-basic-info) via declarative annotations (toolname / tooldescription on the form, toolparamdescription on each field, including dynamically added education/work and license rows).
In a browser with WebMCP enabled (experimental, e.g. Microsoft Edge with the feature turned on from edge://flags), an AI agent can discover the form and fill it in. Everything still runs locally; no data is sent anywhere.
The help button (?) in the header opens a usage guide. When a new version is available, click "App update" in the menu to apply it.
1. Input Screen
2. Menu
3. Preview (Gothic Font)
4. Preview (Mincho Font)
Resume data is deliberately stored in IndexedDB, not in localStorage, via the Dexie wrapper.
- Structured data: The whole resume (including the education/work and license lists) is stored as a JavaScript object, with no manual
JSON.stringify/JSON.parseround trip. - Promise-based API: Dexie replaces the verbose event-based IndexedDB API with
async/await. - Versioned schema: Dexie's
version().stores()declares the schema, so future data-model changes can be migrated safely. - TypeScript integration: Typed tables (
Table<ResumeRecord, number>) keep the save/load path type-safe.
The only thing kept in localStorage is the light/dark theme preference — a single tiny string that is read synchronously at startup. Resume data never goes there.
- Client-side processing (no server required)
- High-quality Japanese font rendering
- Customizable PDF layout control
- Build / PWA: Vite + vite-plugin-pwa (Workbox Service Worker), TypeScript (strict)
- Framework: React 19 with hooks (no backend, no router); form state lives in a reducer, persisted to IndexedDB by an auto-save effect
- UI: react-bootstrap (Bootstrap 5), Font Awesome, Noto Sans/Serif JP (lazy-loaded), @j1nn0/vanilla-autokana (furigana), @dnd-kit (drag-and-drop reordering of rows)
- Validation: Zod validates imported JSON (
src/models/resume-schema.ts, legacy formats are normalized) and form input (src/models/resume-form-schema.ts) - Quality: Biome (lint/format), Vitest (unit: jsdom + React Testing Library / E2E: Browser Mode + Playwright Chromium)
- Hosting: Netlify (HTTP headers via
public/_headers);public/llms.txtdescribes the site for LLMs / AI agents
WAVE Accessibility Evaluation Results:
- ✅ 0 Errors - No accessibility violations detected
- ✅ 0 Contrast Errors - All text meets WCAG color contrast requirements
- ✅ 0 Alerts - No items flagged for manual review
Tested on 2026-10-03 with the WAVE Evaluation Tool Chrome extension (3.3.1.0)
Bug reports and pull requests are welcome.
Please note that this project uses Takumi Guard in CI workflows to scan dependencies for malware and ensure supply chain security. This scanning only applies to CI and does not affect your local development environment.
This project is licensed under the MIT License. See the LICENSE file for details.