OfferFlow User Guide

Notes about the command format:<br>

• Words in UPPER_CASE are the parameters to be supplied by the user.<br> e.g. in add n/NAME, NAME is a parameter which can be used as add n/Google.
• Items in square brackets are optional.<br> e.g n/NAME [t/TAG] can be used as n/Google t/java or as n/Google.
• Items with … after them can be used multiple times including zero times.<br> e.g. [t/TAG]… can be used as   (i.e. 0 times), t/java, t/java t/React etc.
• Parameters can be in any order.<br> e.g. if the command specifies n/NAME p/PHONE_NUMBER, p/PHONE_NUMBER n/NAME is also acceptable.
• Extraneous parameters for commands that do not take in parameters (such as help, list, exit and clear) will be ignored.<br> e.g. if the command specifies help 123, it will be interpreted as help.
• If you are using a PDF version of this document, be careful when copying and pasting commands that span multiple lines as space characters surrounding line-breaks may be omitted when copied over to the application. </box>

Viewing help : help

Shows you a message explaining how to access the help page.

Format: help

Adding an internship application: add

Adds the internship application you have applied for, to help you keep track of all your applications.

Format: add n/NAME p/PHONE e/EMAIL a/ADDRESS d/DATE r/ROLE s/STATUS [t/TAG]...

Parameters

• n/NAME → Name of the company
• p/PHONE → company telephone number
• e/EMAIL → company email
• a/ADDRESS → company location
• d/DATE → date when you applied
• r/ROLE → job position applied for
• s/STATUS → application progress
• t/TAGS → optional fields

Notes:

• name and role is case insensitive
• Email must use @ symbol
• Applied dates must use YYYY-MM-DD

Examples:

• add n/Google p/96789012 e/google@gmail.com a/70 Pasir Panjang Rd, #03-71 d/2024-06-18 r/Backend Developer s/interviewed t/java
• add n/Google p/12345678 e/careers@google.com a/123 qSilicon Valley d/2025-06-01 r/Software Engineer s/pending

Expected Outcome:

Overwrite duplicate application : overwrite

Overwrites pre-existing application in OfferFlow that has the same name and role, with the new application when you try to add an application with the same name and role as another already existing application

Format: overwrite

If you choose to overwrite, type overwrite. If not, continue using the app as per normal and the new duplication application you were trying to add will be automatically discarded

Expected Outcome (overwrite):

Listing all internship applications : list

Shows a list of all the internship applications you have added on OfferFlow.

Format: list

Expected Outcome:

Editing an application : editmode

Format:

1. editmode INDEX or editmode n/NAME r/ROLE to enter edit mode to edit that particular application
2. Type in any combination of at least one of the parameters below to edit the application
3. exitedit to finish editing and exit the editing mode

Notes:

• Enters editing mode for the application at the specified INDEX or with the specified NAME and ROLE. The index refers to the index number shown in the displayed person list. The index must be a positive integer 1, 2, 3, …
• Once editing mode is entered, all commands except for editexit and editing commands will be disabled.
• Edit the application in edit mode by typing in at least one of the optional fields.
• Existing values will be updated to the input values.
• When editing tags, the existing tags of the person will be removed i.e adding of tags is not cumulative.
• You can remove all the person’s tags by typing t/ without specifying any tags after it.

Parameters

• n/NAME → Name of the company
• p/PHONE → company telephone number
• e/EMAIL → company email
• a/ADDRESS → company location
• d/DATE → date when you applied
• r/ROLE → job position applied for
• s/STATUS → application progress
• t/TAGS → optional fields

Examples:

• editmode 1 or editmode n/Google r/Software Engineer
• a/Mapletree Business City II, Pasir Panjang area t/High Priority
• exitedit

Expected outcome:

Modifying Reminders: Reminder

Use editmode command to modify or create new Reminders.

Format: u/DESCRIPTION ud/DATE Example: u/upcoming interview ud/2026-12-12

• Creates a new upcoming interview Reminder on 12 December 2026.

Use rmr command outside of editmode to remove Reminder of specified Applciation.

Format: rmr <INDEX> or rmr n/<Company_Name> r/<Role> Example: rmr 1 or rmr n/Google r/software engineer

• Removes reminder associated to the specified Application.
• INDEX: Application index reflected on list.
• <Company_Name> <Role>: Application that represents an Application to <Company> for <Role>.

Updating application status: status

Updates the status of an existing application.

Format: status n/COMPANY_NAME r/JOB_ROLE s/STATUS

Parameters

• n/COMPANY_NAME → Name of the company
• r/JOB_ROLE → Role applied for (must match exactly)
• s/STATUS → New status

Valid Statuses

Examples

• status n/Tiktok r/Data Analyst s/Applied
• status n/Google r/Software Engineer s/Interviewing
• status n/Meta r/ML Engineer s/Rejected

Expected Outcome

Locating applications by the company name: find

Helps you finds applications whose company names contain any of the given keywords.

Format: find KEYWORD [MORE_KEYWORDS]

Parameters

• KEYWORD → Name of the company
• [MORE_KEYWORD} → Name of the company

• The search is case-insensitive. e.g google will match Google
• The order of the keywords does not matter. e.g. Google Meta will match Meta Google
• Only the company name is searched.
• Only full words will be matched e.g. Goog will not match Google
• Applications matching at least one keyword will be returned (i.e. OR search). e.g. Google Meta will return Google, Meta

Examples

• find Meta returns all applications applied to Meta
• find Meta Google returns all applications applied to Meta and Google
  

Expected Outcome:

Locating applications with upcoming deadlines: upcoming

Helps you finds applications with upcoming reminders. Also sets OfferFlow to automatically filter for applications with reminders due within the specified number of days on start-up.

Format: upcoming [DAYS]

Parameters

• [DAYS] → An integer X from 0 to 7 inclusive, such that applications with reminders due within X days from today are returned.

• Applications with no reminders at all will not be returned.
• Applications with reminders that are overdue (e.g due prior to the current date) will not be returned.

Examples

• upcoming 0 returns all applications with reminders due within 0 days of today, ergo by today.
• upcoming 7 returns all applications with reminders due within 7 days of today, ergo within a week.

Expected Outcome:

Filtering applications: filter

Filters applications by company, applied date, status, or tag.

Format:

• filter /n /KEYWORD
• filter /d /YYYY-MM-DD
• filter /s /STATUS
• filter /t /TAG

Parameters

• KEYWORD → Name of the company
• YYYY-MM-DD → date
• STATUS → application progress
• TAG → tags in the application

Notes:

• Filter matching is case-insensitive.
• Leading and trailing spaces are ignored.
• Internal spacing still matters.
• Applied dates must use YYYY-MM-DD.

Examples:

• filter /n /Google
• filter /d /2025-11-11
• filter /s /Applied
• filter /t /java

Expected Outcome

Deleting an application : delete

You can delete a specified application from OfferFlow via index or reference via Company name and Role.

Format: delete INDEX

• Deletes the Application at the specified INDEX.

Parameters

• INDEX → the index number shown in the displayed application list

Examples

• delete 2 deletes the application displayed at index 2

Expected Outcome:

Format: delete n/NAME r/ROLE

• Deletes the specific Name and Role Application

Parameters

• NAME → company name
• ROLE → job position

Examples

• delete n/google r/Backend Developer deletes the application for Google as Backend Developer.

Expected Outcome:

Creating a new address book : folder

Creates a new empty address book saved under data/FOLDER_NAME.json and switches to it.

Format: folder FOLDER_NAME

Parameters

• FOLDER_NAME → Name for the new address book (letters, numbers, underscores, and hyphens only)

Examples

• folder Y1S2 creates and switches to a new address book at data/Y1S2.json
• folder internships-2025 creates and switches to data/internships-2025.json

Expected Outcome:

• A new empty address book is created and you are switched to it immediately.
• The status bar at the bottom of the window updates to show the current file path (e.g. ./data/Y1S2.json).

---

Switching to an existing address book : toggle

Switches to an existing address book saved under data/FOLDER_NAME.json.

Format: toggle FOLDER_NAME

Parameters

• FOLDER_NAME → Name of the existing address book to switch to

Examples

• toggle Y1S2 switches to the address book at data/Y1S2.json
• toggle internships-2025 switches to data/internships-2025.json

Expected Outcome:

• You are switched to the specified address book and its applications are loaded.
• The status bar at the bottom of the window updates to show the current file path (e.g. ./data/Y1S2.json).

---

Listing all address books : folders

Lists all existing address books saved in the data directory.

Format: folders

Expected Outcome:

• All available address book names are displayed (one per line), sorted alphabetically.
• If no address books exist yet, a message is shown indicating the data directory is empty.

Examples

Folders available:
internships-2025
Y1S2
Y2S1

---

Clearing all entries : clear

⚠️ Removes ALL applications. Use with caution.

You can delete all applications on OfferFlow with just 1 command hassle-free!

Format: clear

Exiting the program : exit

Closes OfferFlow.

Format: exit

Saving the data

OfferFlow data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually.

Editing the data file

OfferFlow data are saved automatically as a JSON file [JAR file location]/data/addressbook.json. Advanced users are welcome to update data directly by editing that data file.

Archiving data files [coming in v2.0]

Export past applications into different folder to declutter your active list.

---

FAQ

Q: How do I transfer my data to another Computer?
A: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous OfferFlow home folder.

---

Known issues

1. When using multiple screens, if you move the application to a secondary screen, and later switch to using only the primary screen, the GUI will open off-screen. The remedy is to delete the preferences.json file created by the application before running the application again.
2. If you minimize the Help Window and then run the help command (or use the Help menu, or the keyboard shortcut F1) again, the original Help Window will remain minimized, and no new Help Window will appear. The remedy is to manually restore the minimized Help Window.

---

Glossary

1. GUI: Graphical User Interface (GUI) is a visual way to interact with a computer, using icons, menus, and pointers rather than typed commands.

---

Command summary