Vigil User Guide

• Prop firm traders on any major firm (FTMO, TopStep, Apex, The5%ers, FundedNext, MyFundedFX, and more)
• Traders in challenge phases or funded accounts
• Anyone who wants an objective, AI-driven check on whether they followed their own rules

• URL: https://runvigil.app
• Supported browsers: Chrome, Firefox, Safari, Edge (modern versions)
• Mobile: Responsive web design -- works on phone and tablet browsers
• Account required: Free tools (quizzes, simulator, strategy analyzer) work without signup. The dashboard and audit features require a free account.

1. 1.Navigate to https://runvigil.app/login
2. 2.Choose one of two sign-in methods:

• Google: Click "Continue with Google" to authenticate via your Google account
• Magic Link: Enter your email address and click "Send Magic Link." Check your inbox for a login link (no password needed).

1. 1.After signing in, you are redirected to the dashboard. If this is your first visit, you will be taken to the onboarding wizard instead.

Tip: Vigil uses passwordless authentication. There is no password to remember or reset. Each login generates a fresh magic link, or you can use Google OAuth.

1. 1.Run the quick starter audit in onboarding to get an immediate baseline compliance score
2. 2.Personalize Vigil with your prop firm, account size, and trading rules
3. 3.Finish onboarding, then upload your first real chart screenshot on the Audit page
4. 4.Explore the dashboard to see your compliance tracking, streak, and calendar

The first screen gives you a fast starter audit using a short demo checklist. Enter basic trade details such as symbol, direction, entry, exit, and optional stop loss. You can also attach a screenshot for context.

This step is intentionally lightweight. It is meant to show how Vigil thinks before your real prop-firm rules are loaded.

Click Continue to proceed.

A grid of firm cards appears, each showing the firm's abbreviation and name. Click the card for your firm. Supported firms include FTMO, TopStep, Apex, The5%ers, FundedNext, MyFundedFX, and many more.

If your firm is not listed, click the "Other" card and type your firm name in the text field that appears.

For recognized firms, Vigil shows the actual account sizes available at that firm (e.g., USD 25,000 / USD 50,000 / USD 100,000 / USD 200,000). Click the card matching your account.

Below the account sizes, select your current phase using the radio buttons:

• Challenge Phase 1
• Challenge Phase 2
• Funded
• (Firm-specific phases may vary)

For custom firms, you enter the account size manually and select from generic phase options.

Click Continue to proceed.

Vigil pre-loads rules based on your selected firm, account size, and phase. These include:

• Maximum daily loss (actual dollar amount from your firm's rules)
• Maximum total loss / drawdown
• Profit target (if applicable)
• News trading restrictions
• Weekend and overnight holding rules

Each rule has a category dropdown (Entry, Exit, Risk, Timing, Indicator) and a text field. You can:

• Edit any pre-loaded rule by changing its text
• Delete a rule by clicking the trash icon
• Add a new rule by clicking "Add rule"

When you are satisfied with your rules, click Continue.

Tip: Your rules are saved to both localStorage (for the audit page) and to the Supabase database (for persistent tracking). You can edit them later from the audit page.

Vigil compares the small starter checklist from Step 1 with your personalized rule set. This screen shows:

• How many rules were in the starter demo
• How many real rules are now loaded for your setup
• A preview of the first personalized rules Vigil will check on your next real audit

This step does not pretend a second AI audit already happened. It is a coverage preview so you can see what changed before auditing a real trade.

The final step lets you choose how you want to log trades going forward:

• Broker sync
• Messaging platforms such as Telegram, Discord, WhatsApp, or email
• Manual logging only

You can skip this step and configure connections later from the dashboard.

The top bar shows:

• Page title: "DASHBOARD"
• Account summary: Your firm name, account size (with currency), and current phase (e.g., "FTMO -- 100,000 USD -- Challenge Phase 1")
• Action buttons: "Import Trades" (goes to CSV import), "Audit a Trade" (goes to audit page), and "Sign out"

The dashboard is composed of six main sections, each loaded with your real data:

Shows your firm name, account size, challenge phase, daily loss limit, and maximum drawdown. This gives you an at-a-glance view of where you stand against your firm's thresholds.

A 30-day heatmap showing your audit streak. Each day is color-coded:

• Green: Audited day with compliance >= 60%
• Red: Audited day with compliance < 60%
• Gray: No trades / inactive

Your current streak count and longest streak are displayed above the heatmap.

A monthly calendar view. Each day cell is shaded based on your compliance score for that day. Click any day to see the individual trades taken on that date, with symbol, direction, and compliance score.

Use the arrow buttons to navigate between months.

Analyzes your rule verdicts to show which rules you follow most consistently and which you violate most often. Helps you identify patterns in your rule-breaking behavior.

Information about the Vigil referral program.

• Announcement Banner: Appears at the top when there are product updates or new features.
• Journal Onboarding Banner: If you have not connected any trading platforms, a prompt appears encouraging you to connect a platform for automatic trade logging.

• You must be signed in
• You must have completed onboarding (rules are loaded from your profile)

1. 1.Upload a Chart Screenshot

• Drag and drop a chart screenshot into the upload zone, or click to browse files
• Accepted formats: PNG, JPG, WebP
• Size limits: Max 5MB, minimum 800x600 pixels
• The image is automatically compressed to 1024px width for efficient processing
• After upload, a preview of your screenshot appears. Click the X button to remove it and upload a different one.

1. 1.Enter Trade Details Fill in the trade information:

• Symbol (e.g., EURUSD, NQ, ES)
• Direction (Long or Short)
• Entry Price
• Exit Price (optional)
• Entry Time
• Exit Time (optional)
• Position Size
• Stop Loss (optional)
• Take Profit (optional)

1. 1.Review Your Rules Your trading rules are displayed below the trade form. They are pre-loaded from onboarding. You can:

• Click the pencil icon to edit rules inline
• Add or remove rules before running the audit
• Changes here update your rules for future audits

1. 1.Click "Run Audit" The AI processes your screenshot and trade data against each rule. A loading indicator appears during processing.

After the audit completes, results appear with animated transitions:

A large percentage score (0-100%) with a color-coded progress bar:

• Green (80%+): Strong compliance
• Yellow (50-79%): Moderate compliance, needs attention
• Red (below 50%): Poor compliance, significant violations

Below the bar: counts of rules followed, violated, and unclear.

Each rule gets its own card showing:

• Verdict icon: Green checkmark (followed), red X (violated), or yellow question mark (unclear)
• Rule text: The rule being evaluated
• Evidence: The AI's explanation of what it saw in the chart
• Verdict badge: Color-coded FOLLOWED / VIOLATED / UNCLEAR label
• Confidence bar: 1-5 rating showing how confident the AI is in its assessment

If applicable, additional firm-specific rules are evaluated separately (e.g., drawdown limits, daily loss limits, news trading restrictions).

Two panels at the bottom:

• Summary: A brief AI-generated overview of the trade
• Recommendation: Actionable advice for improving compliance

The audit result is automatically saved to your account. It appears in:

• Today's Trades on the dashboard
• The compliance calendar
• Your weekly/monthly compliance stats

Tip: Free accounts get 3 audits per month. Pro accounts get 50 audits per month.

1. 1.Navigate to Dashboard > Import Trades (or click "Import Trades" button on the dashboard header)
2. 2.Upload a CSV file exported from your broker platform
3. 3.Vigil parses the CSV and maps columns to trade fields
4. 4.Review the imported trades
5. 5.Confirm the import

The CSV import component handles column mapping automatically for common broker export formats.

Tip: After importing, navigate to the Audit page to run compliance checks on your imported trades.

1. 1.Navigate to Dashboard > Broker Connections (via sidebar or settings)
2. 2.Click "Connect Broker" to open the connection modal
3. 3.Select your broker/platform from the list
4. 4.Follow the platform-specific authentication flow
5. 5.Once connected, your trades will sync automatically every 15 minutes

The connections page shows a grid of your connected platforms. For each connection, you can:

• View status: See when the last sync occurred
• Manually sync: Trigger an immediate trade import
• Disconnect: Remove the connection

Click "Back to Dashboard" to return to the main view.

A grid of analysis cards, each showing:

• Description or analysis date
• Number of rules extracted
• Backtestability score (X/5)
• Pine Script status (ready / not generated)
• Backtest status (backtested / not backtested)
• Iteration number (if refined from a previous analysis)

• Click any card to view the full analysis detail, including extracted rules, Pine Script code, and backtest results
• Click "New Analysis" to go to the Strategy Analyzer tool
• Click "Dashboard" to return to the main dashboard

If you have not run any analyses yet, a prompt appears:

"No strategy analyses yet. Upload a TradingView screenshot to extract your trading rules, generate Pine Script, and backtest your strategy."

Click "Analyze a Strategy" to get started.

1. 1.Upload a TradingView chart screenshot
2. 2.The AI identifies your trading strategy from the chart
3. 3.It extracts discrete, testable trading rules
4. 4.Each rule gets a backtestability score
5. 5.If the strategy is testable enough, Vigil generates a Pine Script for TradingView

• Strategy identification: What setup/strategy the AI detects
• Extracted rules: A list of trading rules with categories (Entry, Exit, Risk, Timing) and testability scores
• Overall backtestability score: 1-5 rating
• Pine Script: Ready-to-paste code for TradingView (when applicable)
• Backtest import: Option to import backtest results from TradingView

If you are signed in, your analyses are saved to the Strategy Lab (/dashboard/strategy) where you can review them, iterate, and track backtest results over time.

Trailing drawdown is one of the most misunderstood rules in prop trading. This simulator lets you:

1. 1.Enter your account size and drawdown parameters
2. 2.Add daily P&L entries (positive or negative)
3. 3.Watch the trailing drawdown floor move in real time
4. 4.See exactly how much buffer you have left

1. 1.Set your starting parameters (account size, drawdown amount)
2. 2.Add daily P&L values one at a time
3. 3.The simulator recalculates the drawdown floor after each entry
4. 4.A visual chart shows your equity curve alongside the drawdown floor

This tool helps you understand how firms like TopStep, Apex, and FTMO calculate trailing drawdown before you risk real money.

At the bottom of the simulator page, a callout encourages you to try Vigil's full audit features:

"Track your real drawdown with AI compliance audits. Upload your actual trades. Vigil checks them against your firm's drawdown rules and flags violations before they cost you your account."

1. 1.Go to /quiz and click on any quiz card
2. 2.Answer the multiple-choice questions
3. 3.View your instant results on the results page

Each quiz card shows the title, description, number of questions, estimated time, and a badge (e.g., "Most Popular" or "New").

Displays:

• Email: Your account email address
• Plan: Your current plan (Free, Pro, or Pro+) shown as a badge
• Audits this month: Usage counter (e.g., "2 / 3" for free, "12 / 50" for Pro)

Actions:

• Manage Subscription: Opens the Stripe Customer Portal where you can update payment methods, view invoices, or cancel
• Upgrade Plan: Links to the pricing page

Export or delete your data.

• Download all data: Export trades, rules, and tracking records. Available in JSON format (single file with everything) or CSV format (split by data type, with trades formatted for spreadsheet analysis).

For Pro subscribers:

• Platform Connections: Connect Telegram, Discord, WhatsApp, or email for conversational trade logging
• Journal Preferences: Configure how you want to log trades

For free users, this section shows a prompt to upgrade to Pro.

Permanently delete your account and all associated data.

1. 1.Click "Delete My Account"
2. 2.A confirmation panel appears with a text input
3. 3.Type DELETE (exact, case-sensitive) to enable the confirmation button
4. 4.Click "Permanently Delete Account"
5. 5.Your account, trades, rules, and tracking data are permanently removed
6. 6.You are signed out and redirected to the home page

This action cannot be undone.

• 3 audits per month
• Dashboard overview
• Drawdown tracker
• Pre-loaded firm rules

• 50 audits per month
• Full analytics suite
• CSV trade import
• Compliance calendar
• Priority support
• All firm rule sets

• Everything in Pro
• Multi-agent audit (4 AI specialists)
• Deep pattern analysis
• Risk behavior profiling
• Custom rule builder
• Dedicated support

1. 1.Go to /pricing
2. 2.Click the paid plan you want on the pricing page
3. 3.You are redirected to Stripe Checkout
4. 4.Complete payment
5. 5.Your account is immediately upgraded and the matching plan features unlock

• Go to Settings > "Manage Subscription" to open the Stripe Customer Portal
• From there you can update payment methods, view invoices, change plans, or cancel

The pricing page includes an expandable FAQ section addressing common questions about plans, billing, and features.

The sticky top bar contains the Vigil logo (links to home) and these links:

When signed in, the navigation also provides access to the dashboard.

From within the dashboard, navigation happens via:

• Header buttons: "Import Trades" and "Audit a Trade"
• Direct URLs: /dashboard, /dashboard/audit, /dashboard/import, /dashboard/connections, /dashboard/settings, /dashboard/strategy
• Back buttons: Each sub-page has a "Back to Dashboard" button

What it means: You are not logged in, or your session has expired.

How to fix: Click "Go to Sign In" or navigate to /login. Sign in again with Google or magic link.

What it means: Your chart screenshot is too small. Vigil needs at least 800x600 pixels to reliably read chart data.

How to fix: Take a larger screenshot. On most platforms, use the full browser window or increase your chart size before capturing.

What it means: Your image file is too large.

How to fix: Compress the image or save it as JPEG instead of PNG. Most chart screenshots compress well as JPEG.

What it means: You tried to upload an unsupported file format (e.g., GIF, BMP, TIFF, PDF).

How to fix: Save your chart as PNG, JPG, or WebP before uploading.

What it means: The AI could not confidently determine whether rules were followed or violated based on the screenshot.

How to fix:

• Ensure your screenshot clearly shows entry/exit markers, stop loss levels, and relevant indicators
• Fill in all trade detail fields (symbol, direction, entry/exit prices, stop loss)
• Use a clean, uncluttered chart view

What it means: Your profile has a firm ID that does not match any known firm.

How to fix: Navigate to /dashboard/onboarding and complete the setup wizard again.

What it means: You have not audited any trades for the selected month.

How to fix: Run audits on your trades. Each audited trade automatically populates the calendar and compliance tracking data.

What it means: The magic link email may be delayed or filtered.

How to fix:

1. 1.Check your spam/junk folder
2. 2.Wait 2-3 minutes (email delivery can be slow)
3. 3.Try again with "Use a different email" if needed
4. 4.Use Google sign-in as an alternative

What it means: You have used all your monthly audits (3 for Free, 50 for Pro).

How to fix: Upgrade to Pro for 50 audits/month, or wait until the next calendar month when your limit resets.