PoSolana Suite Documentation

Your complete guide to leveraging the full power of decentralized commerce.

1. Introduction & Philosophy

Welcome to the PoSolana Suite, your all-in-one solution for running a modern business on the Solana network. This platform is a comprehensive toolkit, integrating Point of Sale (POS), Inventory Management, Invoicing, Customer Relationship Management (CRM), and advanced Analytics into a single, cohesive interface. This guide provides an in-depth walkthrough of every feature, from initial setup to advanced data management, helping you harness the full power of decentralized commerce.

A foundational principle of the suite is data privacy and user control. All your critical business data is stored exclusively in your local browser storage. This means no cloud servers, no monthly data fees, and no third-party access to your information. You are the sole custodian of your data, ensuring maximum privacy and security.

2. PoSolana Whitepaper: A Non-Custodial POS Model

2.1 Abstract: Absolute Merchant Sovereignty

PoSolana is a decentralized, non-custodial Point-of-Sale (POS) suite designed for the Solana ecosystem. Our core philosophy is **Absolute Merchant Sovereignty**, achieved through two key design choices: zero-custody payments via Solana Pay and localized data storage. This model eliminates centralized risk, subscription fees, and reliance on third-party data infrastructure.

2.2 Decentralized Payment Rail (Solana Pay)

All crypto transactions adhere to the Solana Pay standard. This is paramount because payments flow directly from the customer's wallet to the merchant's configured wallet address. PoSolana never takes possession of, custody of, or intermediate control over funds, making the system entirely non-custodial. This eliminates counterparty risk and allows the merchant immediate settlement.

2.3 Data Infrastructure & Fees

All business intelligence data—including Inventory, CRM profiles, and historical Transactions—is persisted exclusively in the merchant's local browser storage (localStorage). This results in zero cloud storage costs and prevents external data breaches. The only cost associated with operating the system is the minute Solana transaction fee paid by the customer. Merchants are strongly advised to use the Data Management tools for frequent, external backups.

3. Getting Started: A Detailed Tutorial

Follow this detailed, step-by-step guide to take your store from zero to fully operational in just a few minutes.

  • Step 1
    Initial Store Setup
    The first time you launch the application, you'll be guided through a brief, one-time setup process. This is where you'll establish the core identity and security of your store. You will be asked for three key pieces of information:
    • Store Name: This is the public name of your business (e.g., "Solana Coffee"). It will appear on receipts and invoices.
    • Wallet Address: This is the public Solana wallet address where all customer payments will be sent. Double-check this for accuracy!
    • Admin PIN: This is a 4-digit PIN that you will create. It grants access to all manager-level features, including settings, analytics, and employee management. Keep this PIN secure.


  • Step 2
    Add Your First Product
    You can't make a sale without something to sell! Navigate to the Inventory page using the main navigation bar. Here, you'll find the tools to manage your entire catalog. Click "Add New Item" to open the product creation modal. You can define its name, price, cost, and stock quantity. For items with options like size or color, you can use the "Variable Product" type to create different versions, each with its own price and stock level.


  • Step 3
    Process Your First Transaction
    With a product in your inventory, it's time to make a sale. Go to the Point of Sale (POS) page. Use the "Add Item" button to select the product you just created, or use the keypad to enter a custom sale amount. Once the charge is ready, you have two options:
    • Pay with Crypto: This generates a unique Solana Pay QR code. Your customer scans this with their wallet app to complete the payment.
    • Pay with Card: If you've configured Stripe in the settings, you can accept traditional credit and debit card payments.


  • Step 4
    Review Your Dashboard
    After your first sale, navigate back to the Dashboard. This is your business's command center. You will see your new transaction instantly reflected in the "Key Metrics" and "Recent Transactions" widgets. All financial figures are converted to their current USD value in real-time, giving you an accurate, at-a-glance overview of your performance.


  • Step 5
    Explore and Configure
    Congratulations, your store is operational! Now is a great time to explore the other sections. Go to the Settings page to add your business logo and address for receipts. If you have a team, you can add them in the "Manage Employees" section. Finally, check out the new Time Clock page to see how your staff can manage their shifts.

4. In-Depth Feature Guide

Dive deep into the core components of the PoSolana Suite.

Global Barcode Scanning: Checkout Instantly

The Point of Sale now supports true "keyboard wedge" barcode scanners. This means any USB or Bluetooth scanner acts as a simple keyboard to input product codes. Critically, the system actively listens for rapid input ending in `Enter` from **any screen view on the POS**, eliminating the need to click into the search field. This is the fastest way to ring up sales.

Advanced Discounts: Run Sales & Campaigns

The Discounts module (accessible via Settings) provides two layers of savings flexibility:

  • Coupons: Create static codes (e.g., "HOLIDAY25") for a fixed dollar amount or percentage off the cart subtotal.
  • Manual Discounts: Apply a one-time fixed or percentage discount manually at the POS screen.

**Note on Calculation:** All discounts are applied to the subtotal *before* tax, ensuring accurate sales tax reporting. Loyalty point redemption is automatically disabled if an Order Discount is applied to the cart.

User & Role Management: Secure Your Operations

The PoSolana Suite now includes a robust user management system. As an administrator, you can create accounts for your staff with two distinct roles: Manager and Employee. Each user has a unique, secure PIN for logging in. Managers have full access to all features, including settings and analytics, while Employees have a focused view, limited to the Point of Sale and the new Time Clock, ensuring your sensitive business data remains protected.

Employee Time Clock: Track Hours with Ease

Our new Time Clock is a simple yet powerful tool for managing your team's hours. Accessible to all logged-in users, it provides a clean, mobile-friendly interface where employees can use their PIN to Clock In, Start/End Breaks, Start/End Lunch, and Clock Out. Every action is timestamped and recorded, providing an accurate log for payroll and performance tracking.

Credit Card & Hybrid Payments: Bridge Web2 and Web3

The PoSolana Suite now allows you to serve all your customers, regardless of how they prefer to pay. By integrating with Stripe, you can now accept credit and debit card payments alongside your existing crypto options. To enable this, simply add your secure Stripe API keys in the settings. When you create a charge, you'll see a "Pay with Card" button. The system will automatically convert any crypto amount to its current USD value for the card transaction, providing a seamless experience for you and your customer.

Point of Sale (POS): The Heart of Your Operations

Our POS is engineered for speed, flexibility, and ease of use in any retail environment. You can create charges by adding pre-defined products from your inventory, or by entering a custom amount on the built-in keypad. The system supports multiple cryptocurrencies and now, with Stripe, traditional card payments. For crypto, a Solana Pay QR code is generated for the customer to scan, and the transaction status updates in real-time as soon as the payment is confirmed on the Solana network.

Inventory Management: Your Digital Stockroom

Our comprehensive inventory system is designed to provide full control over your stock. It now supports both **Simple Products** (with a single stock count) and **Variable Products** for items with multiple options like size or color. Each variant can have its own SKU, price, cost, and barcode, and its stock is tracked individually, giving you a precise and granular view of your inventory at all times.

CRM (Customer Relationship Management): Build Stronger Relationships

Our CRM is a powerful suite of tools designed to help you build and maintain strong relationships with your customers. It automatically tracks each customer's full purchase history, including the specific product variants they bought. The CRM also features customer tagging for easy segmentation and a communication log to track all your interactions.

Invoicing: Professional and Seamless Billing

Create, manage, and track professional invoices for your clients. You can either select an existing customer from your CRM or add a new one on the fly. Invoices can be populated with items from your inventory—including specific product variants—or with custom line items. Each invoice generates a unique Solana Pay QR code for direct payment, and the system automatically checks for on-chain payment confirmation.

Analytics: Data-Driven Decisions

The Analytics page gives you a clear and comprehensive overview of your business's performance. All financial data is converted to its real-time USD value for accuracy. You can view sales by payment method (including "USD" for card payments), and because we track costs for each product variant, your profitability metrics are always precise.

5. Data, Security, and Backups

Important: Your data is stored locally in your browser. It is crucial to export your data regularly to prevent loss.

6. Frequently Asked Questions (FAQ)

Where is my data stored?

Your data is stored exclusively in your web browser's local storage. It is not sent to any external servers, ensuring you have complete control and privacy over your information.

What happens if I clear my browser cache?

Clearing your browser's cache or site data will permanently delete all your store's information. It is crucial to export your data regularly using the "Export Data" feature in the settings to prevent data loss.

Is this a custodial service?

No. The PoSolana Suite is completely non-custodial. We never have access to your private keys or your funds. All payments go directly from your customer's wallet to the merchant wallet you configure during setup.

What wallets are compatible?

Any Solana wallet that supports the Solana Pay protocol can be used by customers to make payments. This includes popular wallets like Phantom, Solflare, and others.

Can I use this on multiple devices?

Yes, but you will need to use the "Export Data" and "Import Data" features to transfer your store's data between devices. Since all data is stored locally in the browser, it is not automatically synced across different devices.

7. Update Notes

Advanced Discounts and Global Scanning (0.9.3) - Oct 2025
  • Implemented Global Barcode Scanner (Keyboard Wedge) listener for instant, click-free item addition on the POS.
  • Added a full Coupon and Discount management system, allowing creation of fixed ($) or percentage (%) discounts applied to the cart subtotal.
  • Discounts are applied pre-tax for correct calculation.
  • Loyalty Point redemption is now disabled if a cart discount is active to prevent complex stacking.
  • Fixed minor UI issues in the Manage Coupons section.
Loyalty & Employee Management (0.9.2) - Sep 2025
  • Added a full Loyalty Points system (1 pt per $1 USD spent) integrated into CRM and POS.
  • Implemented Loyalty Redemption feature for discounts at checkout.
  • Introduced Time Clock for employee shift tracking and payroll reports.
  • Added employee roles (Manager/Employee) for access control.
Stripe, Invoicing, and Inventory V2 (0.9.1) - Aug 2025
  • Integrated Stripe for Credit/Debit card payments on the POS.
  • Added comprehensive Invoicing module with Solana Pay QR codes.
  • Upgraded Inventory to support Variable Products (variants, separate SKUs/stock for size/color, etc.).
  • Added Inventory Locations management.
Initial Launch (0.9.0) - Jul 2025
  • Launched core Point of Sale (POS) and CRM functionality.
  • Implemented local storage for non-custodial, private data management.
  • Added multi-token support (SOL, USDC, BONK) via real-time CoinGecko pricing.