Skip to content

hidao80/ShigotoForm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

49 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ShigotoForm

Netlify Status License: MIT Accessibility

ShigotoForm is a project designed to help job seekers, students, and career changers easily and quickly create professional PDF resumes and streamline the job application process. With an intuitive interface and no technical skills required, users can build a professional-quality resume efficiently. All user data is stored locally in the browser and never transmitted to any servers, ensuring maximum privacy. Saved resume data can be exported and imported as JSON files for easy backup or transfer.

This README provides an overview of the project, setup instructions, and contribution guidelines.

Table of Contents

πŸ”’ Security & Privacy

  • Client-side only: No data transmission to external servers
  • Local storage: All data remains in your browser
  • Privacy-first: Designed with personal data protection in mind
  • Future enhancement: Local encryption planned for additional security

Installation

To install ShigotoForm, follow these steps:

  1. Clone the repository:

    git clone https://github.com/yourusername/ShigotoForm.git
  2. Navigate to the project directory:

    cd ShigotoForm
  3. Install the necessary dependencies:

    npm install

Usage

To start using ShigotoForm, run the following command:

npm start

This will start the application on http://localhost:3000.

Input Instructions

  1. Full Name: Enter your full name in the text box. Furigana will be auto-filled to some extent.
  2. Date of Birth: Select a date from the calendar or enter it in YYYY/MM/DD format.
  3. Address: Enter your postal code for auto-completion. Please enter the detailed address manually.
  4. Phone Number: Enter numbers in half-width digits without hyphens.
  5. Email Address: Enter a valid email address format.
  6. Education/Work History: Enter your educational and work history in a list format. You can add or remove rows using the "Add" or "Delete" buttons.
  7. Qualifications/Licenses: Enter your qualifications and licenses in a list format. You can add or remove rows using the "Add" or "Delete" buttons.

Import/Export

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.

Preview

The content entered on the input screen can be previewed in A4 paper size.
At this time, you can select either Gothic or Mincho font.

By clicking the "Download Resume PDF" button at the bottom right of the preview screen, you can download the preview content as a PDF.

πŸ“Έ Screenshots

  1. Input Screen:
Input Screen
  1. Menu:
Menu
  1. Preview (Gothic Font):
Preview (Gothic Font)
  1. Preview (Mincho Font):
Preview (Mincho Font)

πŸ› οΈ Technology Choices

Why Dexie over localStorage?

  • Larger storage capacity for resume data
  • Better async handling with Promise-based API
  • TypeScript integration for type safety

Why html2pdf.js?

  • Client-side processing (no server required)
  • High-quality Japanese font rendering
  • Customizable PDF layout control

⚑ Performance Metrics

πŸ“± Mobile Results

Performance-73-yellow Accessibility-100-green Best_Practices-96-green SEO-100-green

First_Contentful_Paint-4.2s-red Largest_Contentful_Paint-4.6s-red Total_Blocking_Time-0ms-green Cumulative_Layout_Shift-0-green Speed_Index-4.2s-red

πŸ–₯️ Desktop Results

Performance-99-green Accessibility-96-green Best_Practices-100-green SEO-100-green

First_Contentful_Paint-0.8s-green Largest_Contentful_Paint-0.9s-green Total_Blocking_Time-0ms-green Cumulative_Layout_Shift-0-green Speed_Index-0.9s-green

Tested on: 2025-08-11 using Google PageSpeed Insights

β™Ώ Accessibility Compliance

WAVE Accessibility Evaluation Results:

  • βœ… 0 Errors - No accessibility violations detected
  • βœ… 0 Contrast Errors - All text meets WCAG color contrast requirements
  • ⚠️ 2 Alerts - Minor suggestions for enhancement
  • 🎯 1 Feature - Accessibility features properly implemented

Tested with WAVE Web Accessibility Evaluator on 2025-08-11

πŸ‘₯ Contributing

We welcome contributions to ShigotoForm! To contribute, follow these steps:

  1. Fork the repository.

  2. Create a new branch:

    git checkout -b feature-branch
  3. Make your changes and commit them:

    git commit -m "Description of changes"
  4. Push to the branch:

    git push origin feature-branch
  5. Create a pull request.

πŸ—ΊοΈ Roadmap

Planned Improvements

  • React + TypeScript migration
  • Enhanced accessibility testing

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

About

ShigotoForm is a project designed to streamline and simplify job application processes.

Topics

Resources

License

Stars

Watchers

Forks