Documentation

Documentation

Authentication & Security

Narrative Pro employs modern, passwordless authentication methods that prioritize both security and user experience. Our authentication system is built on proven technologies that eliminate common security vulnerabilities while providing seamless access to your account.

Magic Link Authentication

Magic links represent the future of secure authentication. Instead of relying on passwords, our system sends a unique, time-limited authentication link directly to your email address.

How Magic Links Work

The Process
  1. Enter your email address on the login page
  2. Receive a secure authentication link via email
  3. Click the link to authenticate instantly
  4. Access your account without entering passwords
Security Features
  • Time-limited tokens (expire after 1 hour)
  • Single-use authentication links
  • Email verification built-in
  • No password storage vulnerabilities

Why Magic Links Are Superior

Security Advantages

  • No Password Vulnerabilities: Eliminates risks from weak, reused, or compromised passwords
  • Phishing Resistance: Unique tokens cannot be reused by attackers
  • Credential Stuffing Protection: No stored credentials to be breached
  • Built-in 2FA: Email access serves as a second authentication factor
  • Automatic Expiration: Links become invalid after use or timeout

User Experience Benefits

  • No Password Management: Nothing to remember, store, or reset
  • Instant Access: One-click authentication from email
  • Cross-Device Friendly: Works seamlessly across all devices
  • Reduced Friction: Faster login process for returning users
  • Universal Compatibility: Works with any email client

OAuth Integration (Google Auth)

For users who prefer social authentication, we offer seamless Google OAuth integration using industry-standard PKCE (Proof Key for Code Exchange) flow.

OAuth Benefits

  • Leverage existing Google account security
  • No additional password creation required
  • Automatic account linking
  • Streamlined registration process

Security Standards

  • PKCE flow prevents code interception
  • Secure token exchange
  • No password exposure to our systems
  • Google's enterprise-grade security

Technical Implementation

Our authentication system is built on Supabase Auth, providing enterprise-grade security with multiple fallback mechanisms:

Multi-Flow Compatibility

  • Custom Auth Domain: Supports custom authentication domains for enterprise deployments
  • Code-based Flow: Server-side token exchange for enhanced security
  • Token-based Flow: Client-side processing for optimal performance
  • Automatic Detection: System automatically selects the appropriate flow

Security Infrastructure

Data Protection:

  • End-to-end SSL/TLS encryption
  • Secure session management
  • Automatic session expiration
  • CSRF protection

Standards & Infrastructure:

  • Enterprise-grade infrastructure providers
  • GDPR compliant data handling
  • OAuth 2.0 and OpenID Connect standards
  • Industry-standard security practices

Resume Builder Methodology

The Resume Builder represents a revolutionary approach to resume creation, leveraging your existing narrative statements to generate tailored, professional resumes. Our AI-powered system analyzes your narratives and transforms them into compelling resume content that aligns with specific job titles and career goals.

Intelligent Narrative Analysis

At the core of our Resume Builder is sophisticated AI analysis that understands the context and value of your professional narratives. The system examines your selected narratives to extract key insights and transform them into resume-appropriate content.

Analysis Process

Content Extraction
  • Identifies key skills and competencies
  • Extracts quantifiable achievements
  • Recognizes leadership indicators
  • Maps technical expertise
  • Analyzes impact and scope
Context Understanding
  • Interprets military-to-civilian translations
  • Understands industry terminology
  • Recognizes transferable skills
  • Identifies career progression patterns
  • Maps role responsibilities

AI-Powered Content Generation

Experience Enhancement

Our AI transforms your narrative statements into professional job descriptions and achievement bullets that resonate with hiring managers.

Enhancement Features:
  • Role Abstraction: Converts personal achievements into typical role responsibilities
  • Industry Alignment: Adapts language to match target industry standards
  • Action Verb Optimization: Uses powerful, resume-appropriate action verbs
  • Scope Definition: Clearly articulates the breadth and depth of responsibilities
  • Professional Formatting: Structures content for maximum readability and impact

Skills Extraction & Categorization

The system intelligently identifies and organizes skills from your narratives, creating a comprehensive skills matrix tailored to your target role.

Skill Categories
  • Technical Skills
  • Leadership & Management
  • Communication
  • Project Management
  • Industry Knowledge
Proficiency Assessment
  • Evidence-based proficiency levels
  • Years of experience calculation
  • Context-aware skill relevance
  • Industry-standard terminology

Professional Profile Generation

Creates compelling professional summaries that showcase your unique value proposition and career aspirations.

Profile Elements:
  • Experience Summary: Quantifies years of experience and areas of expertise
  • Key Strengths: Highlights 2-3 core competencies aligned with target role
  • Value Proposition: Articulates unique contributions and achievements
  • Career Direction: Connects past experience to future aspirations
  • Personal Touch: Incorporates relevant interests that demonstrate transferable skills

Job Title Tailoring Process

The Resume Builder's most powerful feature is its ability to tailor content specifically to target job titles, ensuring maximum relevance and impact for each application.

Tailoring Methodology

1. Role Analysis
  • Analyzes target job title requirements
  • Identifies key competencies
  • Maps industry expectations
2. Narrative Mapping
  • Matches narratives to role requirements
  • Prioritizes relevant experiences
  • Identifies transferable skills
3. Content Optimization
  • Adapts language to industry standards
  • Emphasizes relevant achievements
  • Optimizes for ATS systems

Advanced Tailoring Features

Intelligent Content Selection:

  • Prioritizes narratives most relevant to target role
  • Adjusts emphasis based on job requirements
  • Highlights transferable skills and experiences
  • Ensures content alignment with career progression

Dynamic Language Adaptation:

  • Translates military terminology to civilian language
  • Adopts industry-specific vocabulary
  • Optimizes keywords for ATS compatibility
  • Maintains professional tone and clarity

Quality Assurance & Optimization

Every generated resume undergoes comprehensive quality checks to ensure professional standards and maximum effectiveness.

Content Quality Checks

  • Grammar & Style: Ensures professional writing standards
  • Consistency: Maintains uniform tone and formatting
  • Relevance: Verifies content alignment with target role
  • Completeness: Identifies missing critical information
  • Impact: Maximizes achievement visibility and quantification

ATS Optimization

  • Keyword Density: Optimizes for relevant search terms
  • Format Compatibility: Ensures ATS-friendly structure
  • Section Organization: Uses standard resume sections
  • File Format: Provides multiple export options
  • Parsing Validation: Tests readability across ATS systems

Application Methodology

Narrative Pro leverages advanced AI technology to transform how professionals create and manage their narratives. Our application is built on several key principles and features that work together to provide an intelligent, context-aware writing experience.

Core Components

Context-Aware Processing

Our AI analyzes your input within your specific professional context, whether military or civilian, ensuring relevant and accurate suggestions.

Intelligent Feedback

Comprehensive grading and feedback mechanisms help strengthen your narratives through detailed analysis and suggestions.

Secure Storage

The Narrative Vault leverages SSL encryption and Supabase's enterprise-grade security to safely store and manage your narratives.

AI-Powered Analysis

Our system uses advanced language models to provide contextual analysis based on military writing standards and best practices.

Modern Authentication

Our authentication system prioritizes both security and user experience through Magic Link and Google Auth:

Security Benefits
  • No password storage or management required
  • Eliminates risks of weak or reused passwords
  • Prevents credential stuffing attacks
  • Two-factor authentication built into the process
User Experience
  • No passwords to remember or reset
  • Seamless login with existing Google account
  • Simple one-click email authentication
  • Reduced friction during registration

Understanding Claude Tokens & API Keys

What are Claude Tokens?

Claude tokens are the fundamental units of text processing in the Anthropic Claude AI model. Think of them as the building blocks that make up your text - each token represents approximately 4 characters in English, though this can vary based on the specific content.

Token Impact on Processing

  • Processing Capacity: Determines the amount of text that can be analyzed in a single request
  • Response Length: Influences how detailed the AI's responses can be
  • Cost Calculation: Forms the basis for usage billing
  • Performance: Affects processing speed and efficiency

The Role of API Keys

API keys are secure credentials that enable safe communication between Narrative Pro and the Claude AI model. They serve multiple critical functions:

Security Features

  • Encrypted Communication
  • Access Control
  • Request Authentication
  • Usage Tracking

Management Benefits

  • Usage Monitoring
  • Resource Allocation
  • Billing Management
  • Access Revocation

Our Commitment to Transparency

We use Claude API keys directly to ensure complete token transparency. Unlike services that may skim tokens, with Narrative Pro:

  • You get 100% of what you pay for - every token you purchase goes directly to processing your narratives
  • Direct API key usage means transparent token management
  • No hidden token fees or deductions
  • Advanced features are provided through separate subscriptions, not token skimming

Token Management

Optimizing Token Usage

Best Practices

  • Keep narratives focused and concise
  • Use built-in templates
  • Monitor usage patterns
  • Regular usage reviews

Usage Monitoring

  • Track daily consumption
  • Set usage alerts
  • Review efficiency metrics
  • Analyze usage patterns

API Key Security

Protecting your API key is crucial for security and optimal performance:

  • Never share your API key with others
  • Rotate keys periodically (recommended every 90 days)
  • Monitor for unusual activity
  • Store keys securely in your account settings
  • Use environment variables for development

Cost Calculator

Claude API Pricing

Input Costs

  • Standard Input: $0.80/MTok
  • Prompt Cache Write: $1.00/MTok
  • Prompt Cache Read: $0.08/MTok

Output Costs

  • Generated Output: $4.00/MTok
  • 200K context window
  • 50% discount with Batches API

Typical Usage Cost Breakdown

Per Operation Cost

Based on typical usage patterns:

  • Narrative Generation Input: ~300 characters (≈ 75 tokens)
  • Grading Input: ~300 characters (≈ 75 tokens)
  • Output: 300-500 characters (≈ 75-125 tokens)

Cost Estimates

Single Operation:

  • Input Cost: ~$0.00012 (150 tokens × $0.80/MTok)
  • Output Cost: ~$0.0005 (125 tokens × $4.00/MTok)
  • Total per Operation: ~$0.00062

API Credit Examples

$10 API Credit:

≈ 8,064 operations

$50 API Credit:

≈ 40,322 operations

$100 API Credit:

≈ 80,645 operations

$500 API Credit:

≈ 403,225 operations

Getting Started

Basic Access - $5 API Credit:

Start with basic narrative generation:

  • Generate ≈ 4,032 narratives
  • Access to AI-powered narrative creation
  • Basic narrative storage
  • Cost per operation: ~$0.00062

Perfect for evaluating the core narrative generation capabilities.

Premium Features - Subscription Required:

Unlock advanced capabilities:

  • Narrative grading and feedback
  • Advanced Vault features
  • Enhanced analytics
  • Priority support

Subscription plans provide access to our full suite of professional tools, separate from API usage costs.

Frequently Asked Questions

What is the token limit per request?

The standard token limit is 100,000 tokens per request. This includes both your input text and the AI's response. For most narratives, this provides ample room for detailed analysis and suggestions.

How are tokens calculated?

Tokens are calculated based on the character count and complexity of your text. As a rough estimate, one token equals about 4 characters in English, but this can vary based on the specific content (numbers, special characters, etc.).

What happens if I exceed my token limit?

If you reach your token limit, the system will notify you and pause processing. You can either upgrade your plan for more tokens or wait for your allocation to reset (typically at the start of your billing cycle).

Can I transfer tokens between accounts?

Currently, tokens cannot be transferred between accounts. Each account's token allocation is specific to that account and resets according to the account's billing cycle.

How do I monitor my token usage?

You can monitor your token usage in real-time through your account dashboard. The dashboard provides detailed analytics including daily usage, historical trends, and remaining allocation.