1. What is SalesKpr?
SalesKpr is an app that helps you keep track of what you sell and what you buy. Think of it like a digital notebook that remembers:
- Products — the things you sell (name, purchase and sales prices, how many you have in stock)
- Sales — when someone buys something from you (what they bought, how many, and for how much)
- Purchases — when you buy stock or supplies (so you can see your costs)
Everything is saved in your browser on your device. You don't need to create an account. Just open the app and start adding products and sales.
2. Getting started
To use SalesKpr, you only need to do two things first:
- Add at least one product. A product is something you sell — for example "Blue Notebook" or "Business Cards". You give it a name, purchase and sales prices, and how many you have (stock).
- Record a sale when someone buys. You choose the product, how many they bought, and the price. The app then reduces your stock automatically.
The rest of this guide explains each step in detail. If you're new, start with Products, then Selling.
3. Products: adding, editing, and organizing
Adding a new product
- On the Sales page (main dashboard), click the blue New Product button.
- A form will open. Fill in:
- Product Name — e.g. "Premium Leather Notebook"
- Product Type — choose from the list (e.g. Notebook, Notepad). You can add new types by clicking Manage next to Product Type.
- Purchase Price ($) — what you pay per unit (used as the default on the Purchases page)
- Sales Price ($) — what you charge per unit (used as the default on the Sales page)
- Stock Level — how many you have right now (0 is allowed if you are out of stock)
- Status Tag — optional labels like "Running Low", "Coming Soon", or "Discontinued". You can add more by clicking Manage next to Status Tag.
- Product Image — optional. You can upload a image file or paste an image URL.
- Description — optional extra details.
- Click Save Product. Your product will appear on the main grid.
Editing a product
Click on a product card. The same form opens so you can change the name, purchase or sales price, stock, image, or anything else. Click Save Product when done.
Product Type and "Manage"
Product Type is a category (e.g. Notebook, Bill Book). To add a new type: click Manage next to Product Type, type the new name in the box, click Add, then Close. The new type will appear in the dropdown when you add or edit products.
Status Tag and "Manage"
Status tags are labels you can tick for each product (e.g. "Running Low", "Discontinued"). To add a new status: click Manage next to Status Tag, type the new status, click Add, then Close. You can then tick one or more statuses when adding or editing a product.
Product image
You can either upload a file (click the file input and choose an image) or paste an image URL in the "Paste Image URL here..." box. A wide image (like 16:9) looks best on the card.
Sorting and filtering products
Above the product grid you can:
- Sort by — A–Z (name), Date Added (newest first), Top Sales, Low Stock, or High Price.
- Category — show only one product type (e.g. only Notebooks).
- Status — show only products with a certain status (e.g. Running Low).
Click the buttons to change the sort or filter. "Select All" or a category name toggles that filter on or off.
Product history
From a product card you can open History to see a log of changes and sales for that product. Useful to see what happened over time.
4. Selling: cart and recording a sale
When a customer buys something, you don't type the sale once and finish — you add items to a cart, then record the whole sale in one go. That way one customer can buy several different products in a single transaction.
Step 1: Add items to the cart
- On the Sales page, find the product the customer wants.
- Click Add to Cart (or the cart icon) on that product card.
- A small window opens. Enter:
- Quantity — how many units they're buying
- Price per Unit ($) — the price for one unit (often the same as the product price, but you can change it for a discount or special price)
- Remarks (optional) — e.g. "Urgent delivery" or "Red color"
- Click Add to Cart. The window closes and the cart count at the top increases.
Repeat for every product in the same sale. The app will not let you add more than the current stock (e.g. if you have 5 in stock, you can't add 10 to the cart).
Step 2: Open the cart and add the buyer name
- Click the Cart (number) button in the header.
- The cart opens. You'll see all items you added, with quantity and price for each.
- In Buyer / Client Name, type the customer's name (or leave blank for "Guest"). If you've used a name before, you may see suggestions as you type. You can manage the list of buyer names by clicking Manage next to that label.
- Check that the items and quantities are correct. You can Remove any line if you added it by mistake.
Step 3: Finalize and record the sale
- Click the green Finalize & Record Sale button.
- Confirm when asked. The app will:
- Save each item as a sale (with the buyer name and date)
- Reduce the stock for each product
- Clear the cart and close it
You'll see a short message that the sale was recorded. The dashboard totals and rankings will update automatically.
5. Sales Log: viewing, exporting, and fixing mistakes
The Sales Log is the list of all sales you've recorded. Open it by clicking Sales Log in the header.
What you see
A table shows each sale: date, product name, quantity, total amount, and an Actions column.
Voiding a sale (undoing a mistake)
If you recorded a sale by mistake (wrong product, wrong quantity, or duplicate), you can void it:
- Open the Sales Log.
- Find the sale in the table.
- Click the red Void button for that row.
Voiding means "cancel this sale". The sale stays in the list but is crossed out and no longer counted in your revenue or stock. Your stock will go back up as if that sale never happened. If you need to correct stock anyway, you can edit the product and set the correct stock level.
Clear voided entries
After voiding some sales, a Clear Voided Entries button may appear. Clicking it permanently removes all voided rows from the log. Use this only when you're sure you don't need to see them anymore. This cannot be undone.
Export (backup)
Click Export to download a file with all your sales data. This is a good way to keep a backup on your computer. The file is in JSON format (a standard data format).
Import
Click Import and choose a previously exported JSON file. The app will add those sales into your current log. Use this to restore a backup or to move data from another device. Be careful not to import the same file twice or you'll have duplicate sales.
6. Dashboard: revenue and rankings
At the top of the Sales page you see a small dashboard with three numbers and two ranking lists.
The three numbers
- Total Revenue — the sum of all money from sales (excluding voided sales).
- Selected Total — the sum of revenue from the products or buyers you have "selected" in the ranking lists (see below).
- Share of Revenue — what percentage of total revenue comes from the selected items (e.g. "Top 3 products make up 60% of revenue").
Product rankings
The section Product Rankings by Total Sales lists your products from highest to lowest total sales (money). You can click the arrow to expand or collapse this list.
Next to it you have buttons: Select All, Top 3, Top 50%, Top 80%, and Clear. When you click one:
- Select All — selects every product in the list.
- Top 3 — selects only the first three (your best-selling products).
- Top 50% — selects the top half of the list.
- Top 80% — selects the top 80%.
- Clear — removes the selection.
You can also click a single product or buyer row to select or deselect it. When items are selected, Selected Total and Share of Revenue update to show the total and percentage for just those items.
Buyer rankings (top customers)
The section Buyer Rankings (Top Customers) lists people who have bought from you, from who spent the most to the least. The same Select All, Top 3, etc. buttons work here too. Selecting buyers helps you see how much revenue comes from your best customers.
7. Purchases page
SalesKpr has two main areas: Sales and Purchases. You can switch between them using the links in the header.
On the Purchases page you track what you buy (e.g. stock or supplies) instead of what you sell. The idea is the same:
- You have products (the same list as on Sales).
- When you buy stock, you "Add to Cart" with quantity and cost per unit, then finalize. This records the purchase and increases your stock for each product you added.
- The dashboard shows Total Cost, Selected Total, and Share of Cost, plus rankings by total purchases.
- The Purchase Log works like the Sales Log: view, export, import, and void entries.
Use the Purchases page when you want to see how much you're spending on stock and which products cost you the most.
8. Tips and things to remember
- Stock is checked when you add to cart. You can't sell more than you have. Need to fix stock? Edit the product and change the Stock Level.
- Voiding a sale puts the stock back. Use it for wrong or duplicate sales. For small corrections, you can also just edit the product's stock.
- Buyer name is optional; if you leave it blank, the sale is recorded under "Guest". Filling it in helps you see top customers in the Buyer Rankings.
- Product Types and Status Tags are shared across all products. Manage them once and reuse them everywhere.
9. Best practices
Get the most from SalesKpr with these simple habits.
Routines that help
- Export weekly. Set a reminder (e.g. every Sunday) to export your Sales Log and Purchase Log. Keep the files in a folder or cloud drive so you never lose data.
- Use buyer names. Enter the customer's name when you finalize a sale. Over time, the Buyer Rankings show who spends the most — useful for loyalty or bulk discounts.
- Check Top 3 products often. Use the dashboard to see your best sellers. Stock more of those and consider promoting them.
- Use status tags. Mark items "Running Low" when stock is low, "Discontinued" when you stop selling. Filter by status to see what needs restocking.
- Sort by Low Stock. Click the Low Stock sort to see items that need reordering first.
- Track purchases too. On the Purchases page, record what you buy. Compare Total Cost (Purchases) with Total Revenue (Sales) to see your profit margin.
Use cases
Here are a few ways others use SalesKpr:
- Small stationery shop. Add products by type (Notebook, Pen, etc.). Record each sale with the customer name. Weekly export as backup. Use Top 3 and Buyer Rankings to decide what to restock and which customers to thank.
- School fundraiser. Add items (e.g. Candy, T‑shirts). Record sales per class or parent. At the end, export the Sales Log for reports and share of revenue by buyer.
- Craft fair seller. Add handmade products with photos. Record sales at the fair. Use Purchases to log material costs, then compare with Sales to see profit per item.