Help Center
Everything you need to get the most out of TruckCast
Getting Started
How do I add my first event?
Go to Dashboard → Events and click "Add Event". Fill in the event name, date, location, and event type. You can enter the net sales after the event is complete.
What is a "net sales" figure?
Net sales is the total revenue from food and drink sales before subtracting any venue fees or commissions. Do not subtract credit card processing fees — TruckCast handles fee types separately through the fee calculator.
How do I import my historical data?
Go to Dashboard → Events → Import CSV. Your CSV needs at minimum an event_name and event_date column. We also accept net_sales, event_type, location, fee_type, fee_rate, and notes. Dates can be YYYY-MM-DD or M/D/YYYY format.
What happens during onboarding?
Onboarding walks you through four steps: set your business profile, import historical events, optionally connect your POS system, and add your upcoming events. The more history you import, the better your forecasts will be from day one.
Forecasting
How does the forecast engine work?
TruckCast uses a four-level hierarchy. First, it looks for direct history for that exact event. If there isn't enough, it falls back to similar events (same type + area), then to all events of that type, and finally to your monthly average. It tells you which level was used so you know how confident to be.
Why does my forecast show LOW confidence?
Confidence is LOW when you have fewer than 2 data points for an event, or when the sales are inconsistent. Add more event history or log the event a few more times to move to MEDIUM or HIGH confidence.
How does weather affect the forecast?
TruckCast applies a weather coefficient to outdoor events based on the forecast for that day. Rain During Event = 53% of normal, Storms = 30%, Hot (90°F+) = 63%, Cold (≤40°F) = 55%. These coefficients come from 244+ real Wok-O Taco events and recalibrate as your own data accumulates.
Can I override a forecast?
Not directly — the forecast is calculated automatically. If you believe an event will outperform or underperform (e.g., larger expected crowd), add a note to the event explaining why. Manual adjustments are planned for a future update.
Events & Performance
What is the Event Performance table?
The Performance table aggregates your history for each recurring event — average sales, min/max, consistency score, year-over-year trend, and confidence. It recalculates automatically whenever you add or update sales data.
What does "anomaly flag" mean?
Anomaly flags mark events that performed unusually. "Disrupted" events (weather cancellation, venue issue, etc.) are excluded from performance calculations so they don't skew your averages. "Boosted" events performed unusually well.
What are event tiers (A, B, C, D)?
Tiers are your personal rating for each event: A = destination events with high attendance and strong branding, B = solid recurring bread-and-butter events, C = smaller or newer events worth monitoring, D = low-value events not worth rebooking.
How does the fee calculator work?
Select a fee type when logging an event: Flat Fee (deduct a fixed amount), Percentage (deduct % of sales), Commission with Minimum (% of whichever is greater — actual sales or the guaranteed minimum), or Pre-Settled (settlement already happened, net sales is already the take-home).
POS Integrations
Which POS systems are supported?
TruckCast supports Square (OAuth), Clover (OAuth), and Toast (email parsing). POS integrations require a Pro or Premium subscription.
How does Toast integration work?
Toast's API is restricted to enterprise partners, so TruckCast uses email parsing instead. After each service, Toast sends you a daily summary email. Go to Settings → POS → Toast, set up your account, then paste that email into the import panel to pull in your sales.
How often does Square/Clover sync?
Syncing runs daily at 7 AM in your timezone and pulls the previous day's orders. You can also trigger a manual sync anytime from Settings → POS.
What does the sync do with my sales data?
It matches the POS order total to a booked event on that date and updates the net_sales field. If multiple events are booked on the same day, it will prompt you to select which one to apply the sales to.
Billing & Plans
What's included in each plan?
Starter ($29/mo): manual event tracking, fee calculator, performance table, basic dashboard. Pro ($79/mo): adds POS integrations, weather forecasts, public schedule page. Premium ($149/mo): adds organizer quality scoring, risk analysis, monthly reports, confidence bands.
Is there an annual discount?
Yes — annual plans save about 17% versus monthly. Starter annual is $290, Pro is $790, Premium is $1,490.
How do I change or cancel my plan?
Go to Dashboard → Settings → Billing and click "Manage Subscription". This opens the Stripe billing portal where you can upgrade, downgrade, or cancel.
I have a beta invite code. Where do I enter it?
Enter your invite code on the sign-up page before creating your account. The code will grant you a free Pro or Premium trial for the specified period. If you've already signed up, contact support and we'll apply it manually.
Privacy & Data
Can other TruckCast users see my data?
No. TruckCast enforces strict tenant isolation — your events, sales, contacts, and forecasts are only visible to you. Row-level security is enforced at the database level.
Are my POS credentials stored securely?
Yes. OAuth tokens for Square and Clover are stored encrypted in Supabase Vault and are never exposed to the client or transmitted in logs.
Can I export my data?
CSV export is on the roadmap. Currently you can view all your data in the Events and Performance tables. Contact support if you need a data export urgently.