Skip to content

firaseth/capital-compass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

37 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧭 Capital Compass

Navigating Your Investment Future

Professional economic feasibility studies powered by AI. Generate bank-grade investment analysis in minutes, not weeks.

Capital Compass License React AI Powered


🌟 Overview

Capital Compass revolutionizes investment analysis by delivering comprehensive, bank-grade economic feasibility studies in minutes. Our AI-powered platform combines real-time market intelligence with proven financial methodologies to help entrepreneurs secure funding, investors conduct due diligence, and financial institutions evaluate opportunities with confidence.

✨ Key Features

  • ⚑ Lightning Fast: Generate reports in 5 minutes vs. weeks
  • 🌍 Global Coverage: Analysis for 195+ countries across all major sectors
  • πŸ“Š Comprehensive Analysis: Market research, financial projections, risk assessment
  • πŸ’° Bank-Grade Quality: Meets international financial institution standards
  • πŸ”„ Real-Time Data: Current market intelligence, not outdated research
  • πŸ“₯ Instant Download: Professional reports ready for submission

πŸš€ What You Get

Every Capital Compass feasibility study includes:

  • βœ… Executive Summary - Clear project viability overview
  • βœ… Market Analysis - Size, growth rates, trends, competitive landscape
  • βœ… Economic Indicators - GDP, inflation, interest rates, economic outlook
  • βœ… 5-Year Financial Projections - Revenue, costs, profit, cash flow
  • βœ… Financial Metrics - NPV, IRR, ROI, payback period, break-even
  • βœ… Risk Assessment - Market, operational, financial, regulatory risks
  • βœ… Mitigation Strategies - Professional recommendations
  • βœ… Cited Data Sources - Full transparency and credibility

🎯 Who It's For

  • Entrepreneurs & Startups - Secure funding with professional feasibility studies
  • Investment Firms & VCs - Conduct rapid due diligence
  • Financial Institutions - Evaluate loan applications consistently
  • Consultants & Advisors - Enhance client services with instant analysis

πŸ› οΈ Tech Stack

  • Frontend: React 18 + Vite
  • Styling: Tailwind CSS
  • Icons: Lucide React
  • AI: Claude Sonnet 4 (Anthropic API)
  • Data: Real-time market intelligence via web search
  • Deployment: Vercel/Netlify ready

πŸ“¦ Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Anthropic API access (built-in for Claude.ai artifacts)

Setup

# Clone the repository
git clone https://github.com/YOUR-USERNAME/capital-compass.git
cd capital-compass

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

πŸ”§ Configuration

Environment Variables

The application uses the Anthropic API for AI-powered analysis. When running in Claude.ai artifacts, API access is handled automatically. For standalone deployment, you would need to configure API access.

Customization

Edit the following files to customize:

  • src/App.jsx - Main application logic
  • tailwind.config.js - Styling and theme
  • package.json - Project metadata

πŸ’» Usage

  1. Input Project Details

    • Project name and description
    • Industry sector selection
    • Geographic region and country
    • Investment amount and currency
    • Project duration
  2. Generate Study

    • Click "Generate Feasibility Study"
    • AI analyzes real-time market data
    • Comprehensive report generated in minutes
  3. Review & Download

    • Explore interactive report sections
    • Review financial metrics and projections
    • Download formatted report

πŸ“‚ Project Structure

capital-compass/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ App.jsx              # Main application component
β”‚   β”œβ”€β”€ main.jsx             # Application entry point
β”‚   └── index.css            # Global styles
β”œβ”€β”€ public/
β”‚   └── index.html           # HTML template
β”œβ”€β”€ package.json             # Dependencies and scripts
β”œβ”€β”€ vite.config.js           # Vite configuration
β”œβ”€β”€ tailwind.config.js       # Tailwind CSS configuration
β”œβ”€β”€ postcss.config.js        # PostCSS configuration
β”œβ”€β”€ .gitignore               # Git ignore rules
└── README.md                # Documentation

🚒 Deployment

Deploy to Vercel

# Install Vercel CLI
npm install -g vercel

# Deploy
vercel

Deploy to Netlify

# Install Netlify CLI
npm install -g netlify-cli

# Build and deploy
npm run build
netlify deploy --prod

Deploy to GitHub Pages

# Install gh-pages
npm install --save-dev gh-pages

# Add to package.json scripts:
"predeploy": "npm run build",
"deploy": "gh-pages -d dist"

# Deploy
npm run deploy

🎨 Brand Guidelines

Colors

  • Primary: Navy Blue (#0F172A), Ocean Blue (#3B82F6), Royal Purple (#9333EA)
  • Accents: Success Green (#10B981), Gold (#F59E0B)

Typography

  • Headings: Inter/Poppins Bold
  • Body: Inter/Roboto Regular

Logo

Compass icon with upward trending arrow, blue-to-purple gradient


🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ“ž Contact & Support


🌟 Acknowledgments

  • Built with React and Vite
  • Powered by Claude Sonnet 4 (Anthropic)
  • UI components from Lucide React
  • Styled with Tailwind CSS

πŸ“Š Project Status

  • βœ… Core functionality complete
  • βœ… Real-time market data integration
  • βœ… Professional report generation
  • βœ… Responsive design
  • πŸ”„ Multi-language support (coming soon)
  • πŸ”„ API for integrations (coming soon)
  • πŸ”„ Mobile app (planned)

πŸ’‘ Roadmap

Q1 2026

  • Multi-language support (Spanish, French, Arabic)
  • Enhanced data visualization
  • Export to Excel/PowerPoint

Q2 2026

  • REST API for integrations
  • White-label options
  • Advanced scenario modeling

Q3 2026

  • Mobile applications (iOS/Android)
  • Real-time collaboration features
  • Integration marketplace

πŸ™ Support the Project

If Capital Compass helps you secure funding or make better investment decisions, consider:

  • ⭐ Starring the repository
  • πŸ› Reporting bugs and issues
  • πŸ’‘ Suggesting new features
  • πŸ“’ Sharing with your network
  • 🀝 Contributing code or documentation

Made with ❀️ by the Capital Compass Team

Navigating Your Investment Future 🧭

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published