General
What is Upcyclist?
Upcyclist is a cashflow management app built for Facebook Marketplace resellers and other online marketplace sellers. It tracks your inventory, records sales, calculates profit and ROI, and can export data to QuickBooks.
Is my data stored in the cloud?
No. All your data is stored locally on your device using your phone's built-in storage. Nothing is sent to a server. This means your data is private, but you should use the backup/restore feature in Settings to avoid losing it if you switch phones or reinstall the app.
What's the difference between the free and Pro versions?
On mobile, the free version allows up to 10 inventory items, 10 sales, and 10 buyers, and up to 3 lots per item name. CSV import/export and QuickBooks export also require Pro on mobile. The web version has no record limits and all features are available to all users. Upgrading to Pro on mobile removes all limits and unlocks CSV and QuickBooks export.
How do I get the Pro discount?
Enter your email address when prompted during purchase. A discount code will be emailed to you. The discount is applied automatically with the special in-app purchase option that appears after submitting your email.
Does Upcyclist work on tablets?
Yes. The layout adapts automatically — tablets get more columns and a sidebar navigation instead of bottom tabs.
What languages does the app support?
English, French, Spanish, German, and Italian. Change the language in Settings → Language.
Dashboard
What does the Dashboard show?
The Dashboard is your financial command center. It displays: Total Profit (net profit across all completed sales), ROI (return on investment), Monthly Income (profit for the current month), Annualized ROI, NPV (Net Present Value), Cumulative Cash Flow (total revenue minus total invested), and Year-over-Year comparison.
How is profit calculated?
For each sale:
- Total Revenue = sum of (sale price × units sold)
- Sales Tax = Total Revenue × tax rate
- Net Revenue = Total Revenue − Sales Tax − Platform Fees − Shipping − Other Expenses
- Total Cost = sum of (cost per unit × units sold) + Shipping + Other Expenses
- Profit = Net Revenue − Total Cost
- Margin = Profit ÷ Net Revenue × 100
What is NPV and why does it matter?
Net Present Value (NPV) accounts for the time value of money — a dollar today is worth more than a dollar in the future. A positive NPV means your reselling activity is generating real value above your opportunity cost. You can set the discount rate in Settings → Financial Rates.
What is Annualized ROI?
It projects your total profit over a 12-month period based on how many months you have been active. For example, if you earned $600 profit over 3 months, your annualized ROI would be based on a $2,400/year rate. Garage sale events are included by default, but you can toggle "Exclude from annualized metrics" on any garage sale detail screen to remove one-off events from the projection.
Can I filter the Dashboard by category?
Yes. Tap the category filter at the top of the Dashboard to view metrics for a specific item category (e.g., Electronics, Clothing). Select "All" to reset.
Why does Cumulative Cash Flow differ from Total Profit?
Cumulative Cash Flow = Total Revenue − Total Invested (all purchases, including unsold inventory). Total Profit only counts items that have been sold. If you have items you bought but haven't sold yet, Cash Flow will be lower than Profit.
Inventory
How do I add an item?
Tap the + button and fill in: Name (required; items with the same name are grouped as lots), Purchase Price (what you paid in total), Units (how many you bought, defaults to 1), Purchase Date (when you bought it). Optional fields: category, vendor, notes, lot ID.
What are lots?
A lot is a group of items purchased at the same time (e.g., "10 pairs of shoes for $50"). If you buy the same item in multiple separate purchases, each purchase becomes its own lot. Items with the same name are grouped together in the Inventory view automatically.
How does lot grouping work?
Items are grouped by name (case-insensitive). When you tap on a grouped item, you see each lot as a sub-row with its own purchase date, quantity, and cost. The group shows combined totals: total units, available units, average cost, and status.
What does the item status mean?
- Unlisted – in your inventory, not yet listed for sale.
- Listed – actively listed on a marketplace.
- Sold – all units have been sold.
What is FIFO and why does it matter?
FIFO stands for First-In, First-Out. When you record a sale for a grouped item, the app automatically uses the cost from your oldest lot first. This gives you the most accurate profit calculation when you've bought the same item at different prices over time.
What is the "Suggested FIFO Cost" shown when recording a sale?
It's the cost-per-unit of the oldest available lot for that item. This is the cost the app will use by default when generating sale line items, consistent with FIFO accounting.
Can I edit or delete an item?
Yes. Tap any item to open its detail view, then tap Edit. From there you can modify fields or delete the item. Note: deleting an item that has sales recorded against it will affect your profit calculations.
How do I track items that span multiple purchases (lots)?
When you add a new item with the same name as an existing one, the app will ask if you want to add it as a new lot. Tap Yes to group it, and a lot ID (Lot 1, Lot 2, etc.) will be assigned automatically. On the free tier, you can have up to 3 lots per item name.
If I rename an item, do my existing sales update automatically?
Yes. When you save an item with a changed name, the app automatically updates the item name on all existing sales that reference it. This keeps your sale history accurate and prevents any data issues if you later re-edit those sales.
If I edit an item's purchase price, do my existing sales update automatically?
Yes. When you save an item with a changed purchase price, the app automatically recalculates the cost per unit and updates the cost on all existing sales that include that item. This keeps your profit figures accurate without having to re-enter each sale manually.
How do I add photos to an inventory item?
Photo slots are available in both Quick Add and Full Detail modes. Tap either slot to take a new photo with the camera or pick one from your library. Photos are stored on your device and appear throughout the app: as small thumbnails next to each lot in the inventory list, on sale and listing cards in the Sales tab, and as a tappable photo strip in the sale detail view. Note: photo capture requires a native build of the app and is not available in Expo Go.
Sales
How do I record a sale?
- Tap the + button on the Sales tab (or tap Sell on a listed item in Inventory).
- Select the item from the picker.
- Choose Record Sale.
- Enter the sale price, platform (FB Marketplace, eBay, Craigslist, etc.), fees, tax rate, and optional buyer info.
- Tap Save. Profit is calculated and the item's status updates automatically.
What is the difference between "Record Sale" and "List Item"?
- Record Sale – the item has been sold. It counts toward profit and reduces your available inventory.
- List Item – you've posted the item for sale but it hasn't sold yet. It marks the item as "Listed" in Inventory without affecting profit.
How do I convert a listing to a sale?
Go to the Sales tab, find the listed item (filter by Listed), and tap Sell. This opens the sale form pre-filled with listing details for you to confirm.
What platform fees should I enter?
Enter the total marketplace/transaction fee in dollars (not percentage). For example, if Facebook Marketplace charges 5% on a $100 sale, enter $5.
How does the app handle items from multiple lots in one sale?
The sale line items are automatically expanded using FIFO allocation. For example, if you sell 5 units and Lot 1 has 3 available and Lot 2 has 4, the sale will pull 3 from Lot 1 and 2 from Lot 2, each with their respective cost per unit.
Can I add multiple different items to one sale?
Currently each sale transaction is linked to a single item group. For multi-item sales, record each item separately or use the notes field to track bundled deals.
How do I filter sales?
Use the filter buttons at the top of the Sales tab: All, Listed, or Sold.
Can I edit or delete a sale?
Yes. Tap a sale to open its detail view, then tap Edit. Changes to sale price or cost will update your profit metrics on the Dashboard.
How do Garage Sale events work?
Garage Sales let you track items you bring to a physical garage sale, record cash revenue as you collect it during the event, and then close the event to calculate your net profit. Tap the + button on the Sales tab and choose "New Garage Sale". Add the inventory items you're bringing (the app shows your FIFO cost per unit). During the sale, tap "Add Revenue" to log cash collected. When done, tap "Close Event" and enter how many units of each item remained unsold — the app calculates your net profit automatically.
Buyers
What is the Buyers tab for?
It lets you maintain a contact list of people you've sold to. Each buyer can be linked to their sales history, making it easy to see what someone has bought from you and to look up their contact info.
How do I add a buyer?
Tap + and enter their name. Optionally add phone, email, Facebook name, and notes. You can also import a contact directly from your phone's contact list.
How do I link a buyer to a sale?
When recording a sale, tap the Buyer field and select from your saved buyers list, or type a name to create one on the fly.
Can I import buyers from my phone contacts?
Yes. Tap "Import from Contacts" when adding or editing a buyer. The app will request permission to access your phone contacts and let you select one to pre-fill the buyer's details.
How do I see a buyer's purchase history?
Tap any buyer's name to open their detail view. It shows all sales linked to that buyer, including dates and profit.
Settings
What can I customize in Settings?
Currency symbol ($, €, £, ¥, ₹, kr, or custom), Theme (Light, Dark, or System), Language (5 languages), Categories (custom categories with color labels), Financial Rates (NPV discount rate and default tax/fee rates), and Backup & Restore.
How do I back up my data?
Go to Settings → Backup & Restore → Export Backup. This saves a JSON file containing all your inventory, sales, buyers, and settings. Store it in a cloud drive (iCloud, Google Drive, etc.) for safekeeping.
How do I restore from a backup?
Go to Settings → Backup & Restore → Import Backup and select your saved JSON file. This will replace all current data, so use with caution.
How do I create custom categories?
Go to Settings → Categories → Add Category. Choose a name and a color. Categories can be applied to inventory items and used to filter the Dashboard.
What is the NPV discount rate?
This is the interest rate used to calculate Net Present Value — it represents your alternative investment return or cost of capital. A common starting point is 8–10% annually. Adjust it in Settings → Financial Rates.
QuickBooks Export
What QuickBooks export formats are available?
Two formats: QuickBooks Online (exports a CSV file formatted as journal entries compatible with QBO import) and QuickBooks Desktop (exports an IIF file compatible with QuickBooks Desktop import). QuickBooks export is available to all users on the web version and requires Pro on mobile.
What data is included in the QuickBooks export?
You can choose to export Sales, Purchases, or Both.
- Sales export creates journal entries for: Accounts Receivable, Sales Income, COGS, Sales Tax Payable, Platform Fees, and Shipping.
- Purchases export creates entries for: Inventory Asset and Accounts Payable.
How do I export to QuickBooks?
Go to Settings → QuickBooks Export, select the format and date range, and tap Export. The file will be saved to your device and can be shared via email or cloud storage.
Do I need to set up anything in QuickBooks first?
You'll need matching account names in your QuickBooks chart of accounts (e.g., "Sales Income", "COGS", "Inventory Asset"). The export uses standard account names — adjust them in QuickBooks if yours differ.
The QuickBooks export isn't importing correctly.
Ensure your QuickBooks chart of accounts includes accounts with names that match the export (e.g., "Sales Income", "COGS", "Accounts Receivable"). If your account names differ, either rename them in QuickBooks or adjust the journal entries after import.
CSV Import / Export
What can I import and export as CSV?
CSV import and export are available to all users on the web version and require Pro on mobile.
- Inventory – item name, purchase date, price, units, lot ID, category, vendor, notes.
- Sales – transaction status, sale date, platform, buyer name, line items, fees, profit.
- Buyers – name, phone, email, Facebook name, notes.
How do I import items from a spreadsheet?
Go to the Inventory tab and tap the import icon. Your CSV must match the expected column headers. Export your existing data first and use that file as a format guide.
What happens to existing data when I import?
- Add mode – all records from the CSV are added as new entries. They always receive fresh IDs, so no existing records are modified or deleted.
- Replace mode – your current data is completely replaced with the records from the CSV file. Use this with caution, as it cannot be undone unless you have a backup.
How do I fill in the import template?
Download the template from the import screen — it includes sample rows to guide you.
- Inventory – Required: name, purchaseDate, purchasePrice, units. Optional: lotId, procuredFrom, categoryId, notes.
- Sales – Required: saleDate, name, soldPrice. Optional: source, buyerName, buyerContact, salesTaxRate, platformFees, shippingCost, otherExpenses, notes.
- Buyers – Required: name. Optional: phone, email, facebookName, notes.
Dates accept YYYY-MM-DD or M/D/YYYY. Prices accept a plain number or $-formatted value (e.g. 12.50 or $12.50). Leave optional columns blank — do not delete them.
Troubleshooting
My profit looks wrong — what should I check?
- Verify the purchase price and units on the item are correct (cost per unit = purchase price ÷ units).
- Check that platform fees, shipping, and tax rate are entered accurately on the sale.
- If you have multiple lots, confirm that FIFO allocation pulled from the correct lots (tap the sale to view line items).
Items aren't showing as "Sold" even though I recorded a sale.
The item status is calculated from units. If you bought 3 units and only recorded a sale for 2, the item will still show as partially available. Record a sale for the remaining unit to mark it fully sold.
I lost my data after reinstalling the app.
Data is stored locally and is not recovered automatically after reinstalling. Always use Settings → Backup & Restore → Export Backup before uninstalling or switching devices.
The app is not recognizing my phone contacts.
Make sure you've granted Upcyclist permission to access your contacts. Go to your phone's Settings → Privacy → Contacts and enable access for Upcyclist.
The camera doesn't work on Android.
On Android, the app must be granted camera permission before photos can be taken. If the camera isn't opening, go to your phone's Settings → Apps → Upcyclist → Permissions and enable Camera. If you previously tapped "Don't ask again" when the permission prompt appeared, you will need to enable it manually from there.
A sale's unit count or profit looks wrong after I edited it.
This can happen if a sale was saved with an older version of the app before a bug fix was applied. To correct it, open the sale, tap Edit, verify the item quantities and prices, then tap Save. The app will re-calculate the FIFO cost allocation and profit using the correct available units. If quantities still look wrong, check the item's total unit count on the Inventory tab — it must be at least as large as the number of units recorded as sold.
Where do I report a bug or request a feature?
Email us at support@turing605.com or contact us through the app store listing page.
Ready to track your resale profits?
Join resellers who use Upcyclist to stay on top of every dollar.
Get started free