Skip to content

MVP

Pre-release
Pre-release

Choose a tag to compare

View all tags
@pohanson pohanson released this 16 Oct 15:58
· 283 commits to master since this release
v1.3
abc0fd6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

OnlySales v1.3 Release Notes

OnlySales is the CLI-based address book for salespersons to unlock their full potential in managing their customers' contact information

With the release of OnlySales v1.3, we are bringing powerful new features designed to streamline your contact management workflow. This release transforms the original AddressBook Level 3 (AB3) into a specialised tool tailored for sales professionals.

Quick comparison with AB3

Feature AB3 OnlySales v1.3
Contact status ❌ ✅ (6 values)
Find by status ❌ ✅
Find by tag ❌ ✅
Multi-delete ❌ (single only) ✅ (multiple indices)
Bulk import (JSON) ❌ ✅
Bulk export (JSON) ❌ ✅
Email templates ❌ ✅ (status-based)

What's New in v1.3

  • Contact status tracking (6 status values)
  • Find by status and by tag
  • Delete multiple contacts in one command
  • Bulk import/export (JSON)
  • Status-based email templates

1. Contact Status Tracking

Track the status of your customer interactions with the new Status field and command.

Status Field:

  • Each contact now has a status to help you organise your sales pipeline
  • Available status values:
    • Uncontacted - New leads you haven't reached out to yet
    • Contacted - Customers you've already contacted
    • Rejected - Leads that declined your offer
    • Accepted - Customers who accepted your proposal
    • Unreachable - Contacts that couldn't be reached
    • Busy - Customers who are currently unavailable

Command:

status INDEX STATUS

Examples:

  • status 1 Contacted - Mark the 1st contact as contacted
  • status 5 Accepted - Mark the 5th contact as accepted
  • status 3 Busy - Mark the 3rd contact as busy

Screenshot:

image

2. Find Contacts by Status

Quickly filter your contact list based on their current status to focus on the right customers at the right time.

Command:

find s:STATUS

Examples:

  • find s:Uncontacted - Display all leads you haven't contacted yet
  • find s:Accepted - Show all customers who accepted your proposal
  • find s:Busy - View all customers marked as busy

Use Cases:

  • Prioritise follow-ups with uncontacted leads
  • Review all accepted deals for next steps
  • Identify rejected contacts for re-engagement campaigns or removal from contact list

Screenshot:

image

3. Find Contacts by Tag

Enhanced the find command to support tag-based filtering, allowing you to segment customers by categories.

Command:

find t:TAG

Examples:

  • find t:VIP - Show all VIP customers
  • find t:corporate - Display corporate clients
  • find t:2024 - View contact leads obtained in 2024

Combined Searches:
You can combine different search criteria:

  • find n:John t:VIP - Find contacts named John who are VIPs
  • find s:Contacted t:corporate - Find contacted corporate clients

Screenshot:

image

4. Delete Multiple Contacts at Once

Save time by deleting multiple contacts in a single command instead of one-by-one.

Command:

delete INDEX [MORE_INDICES]...

Examples:

  • delete 1 - Delete the 1st contact (single delete)
  • delete 1 2 3 - Delete contacts at positions 1, 2, and 3
  • delete 5 8 12 15 - Delete contacts at positions 5, 8, 12, and 15

Features:

  • Validates all indices before deletion to prevent partial deletions
  • Provides clear feedback showing all deleted contacts
  • Automatically handles index shifting when deleting multiple contacts

Screenshot:

image

5. Import Multiple Contacts (JSON)

Bulk import contacts from a JSON file to quickly populate your contact list from external sources. Use the import command to import the content of your clipboard to your address book. Press F7 for a preview window where supported.

Command:

import

Examples:

import

Features:

  • Import entire address books in JSON format
  • Validates data before import to prevent corruption
  • Provides detailed feedback on import success/failures

Screenshot:
CLI:
image

Preview Window:
image

6. Export Multiple Contacts

Bulk export contacts to JSON to quickly transfer or share your contacts. Use the export command, or press F8 to copy all the contact information to your clipboard where supported.

Command:

export

Examples:

export

Features:

  • Copy entire address books in JSON format to your clipboard
  • Checks for valid data before exporting
  • Provides detailed feedback on export success/failures

Screenshot:

image

7. Email Template Management

Create and manage customised email templates for each contact status, streamlining your outreach workflow.

Open Template:

template s:STATUS

Save Template:

template save

Available Templates:
You can create templates for each status:

  • template s:Uncontacted - Template for first-time outreach
  • template s:Contacted - Follow-up template for contacted leads
  • template s:Rejected - Re-engagement template for rejected leads
  • template s:Accepted - Onboarding template for accepted customers
  • template s:Unreachable - Alternative contact template
  • template s:Busy - Rescheduling template

Workflow:

  1. Open a template: template s:Uncontacted
  2. Edit the template content in the template editor panel
  3. Save your changes: template save
  4. The template is automatically associated with the corresponding status

Features:

  • Status-specific templates for targeted communication
  • Templates persist across application sessions
  • Default templates provided for each status
  • Easy editing and saving workflow

Screenshot:
Template editing
image

Template saving
image

Changes from AB3

1. Updated Command Prefixes

We have standardised all command prefixes in OnlySales to use a colon (:) instead of a slash (/). This avoids confusion when manipulating names that contain dashes. All OnlySales command examples in this document use the new syntax.

Examples:

Command AB3 OnlySales v1.3
Add contact add n/Jane p/91234567 e/jane@example.com a/123 Main St add n:Jane p:91234567 e:jane@example.com a:123 Main St
Find contact find n/John t/VIP find n:John t:VIP
Delete contact delete 1 delete 1

Screenshot:
New Format:
Screenshot 2025-10-16 225531

2. Changes to Compulsory Field

OnlySales requires only name, phone and email when adding a contact. The address field is optional, as salespeople typically do not require addresses for most workflows.

Getting Started

Installation

  1. Ensure you have Java 17 or above installed
  2. Download the OnlySales-v1.3.jar file from the releases section below
  3. Double-click the JAR file or run: java -jar OnlySales-v1.3.jar

Quick Start Guide

Try these commands in the app CLI to explore the new features:

# Add a new contact
add n:Jane Smith p:91234567 e:jane@example.com a:123 Main St

# Set their status
status 1 Uncontacted

# Create an email template for uncontacted leads
template s:Uncontacted

# Edit the template and save it
template save

# Find all uncontacted customers
find s:Uncontacted

# Mark multiple as contacted after your outreach
status 1 Contacted
status 2 Contacted

# Delete outdated contacts
delete 5 8 12

Download

OnlySales v1.3 JAR File: Download here

Documentation

For detailed documentation, please visit:

  • User Guide: [Link to User Guide]
  • Developer Guide: [Link to Developer Guide]

Acknowledgments

OnlySales is based on the AddressBook Level 3 (AB3) project created by the SE-EDU initiative.

Support

Found a bug? Have a feature request?

Happy Selling! 🎉

OnlySales Team

Assets 3
Loading