> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrovisonomics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create your first economic chart in 5 minutes — search indicators, select countries, and visualize data with AI insights

# Quickstart Guide

Create your first economic data visualization in just a few minutes. MACROVISONOMICS turns a plain-English question into an interactive, publication-ready chart backed by 500,000+ indicators from 16+ international sources.

## Step 1: Start a Search

Navigate to the [Dashboard](https://macrovisonomics.com/dashboard) and use the search bar at the top to find economic data.

<Tip>
  Use natural language — the AI understands context and intent, not just keywords. Try:

  * "GDP growth rates since 2010"
  * "Inflation in Europe last decade"
  * "Life expectancy vs healthcare spending"
  * "Debt to GDP ratio for G7 countries"
</Tip>

### Search Modes

You can switch between three search modes using the toggle next to the search bar:

| Mode                 | Description                                                                                 | Best For                                           |
| -------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Neural** (default) | AI understands intent and meaning — "standard of living" finds HDI, income, and consumption | Most searches, exploratory analysis                |
| **Keyword**          | Exact text matching against indicator names and codes                                       | Precise indicator lookups (e.g., `NY.GDP.MKTP.CD`) |
| **Research**         | Deep multi-step AI analysis from 6 parallel sources                                         | Gold+ only — in-depth economic briefings           |

For your first chart, **Neural** mode works best.

## Step 2: Select Countries or Groups

After searching, a panel appears where you can select which countries to include in your visualization.

### Individual Countries

Click on country names to add them one at a time. You can add up to 40 countries in a single chart.

### Economic Blocs (Pro and above)

Select pre-built groups for instant multi-country comparisons:

| Group     | Members                                        |
| --------- | ---------------------------------------------- |
| **G7**    | USA, UK, Canada, France, Germany, Italy, Japan |
| **G20**   | The world's 20 largest economies               |
| **BRICS** | Brazil, Russia, India, China, South Africa     |
| **EU**    | All European Union member states               |
| **OECD**  | 38 member economies                            |
| **ASEAN** | Southeast Asian nations                        |
| **OPEC**  | Oil-exporting countries                        |

### Regional and Income Groups

Alternatively, select by World Bank region or income classification:

* **Regions**: East Asia & Pacific, Europe & Central Asia, Latin America & Caribbean, Middle East & North Africa, North America, South Asia, Sub-Saharan Africa
* **Income tiers**: High Income, Upper Middle Income, Lower Middle Income, Low Income

## Step 3: Choose Your Chart Type

Select the visualization that best communicates your data. The platform auto-suggests the most appropriate type based on your query, but you can override it.

<CardGroup cols={3}>
  <Card title="Line Chart" icon="chart-line">
    Best for trends over time. Shows trajectories and turning points clearly.
  </Card>

  <Card title="Bar Chart" icon="chart-bar">
    Great for cross-country comparisons at a point in time, or stacked distributions.
  </Card>

  <Card title="World Map (Choropleth)" icon="globe">
    Shows geographic patterns — instantly reveals regional clusters and outliers.
  </Card>

  <Card title="Bubble Chart" icon="circle">
    Compare two indicators simultaneously with a third dimension for size.
  </Card>

  <Card title="Radar Chart" icon="chart-radar">
    Multi-dimensional profiles ideal for country scoring and composite indices.
  </Card>

  <Card title="Treemap" icon="chart-treemap">
    Hierarchical size comparisons — great for GDP composition or trade shares.
  </Card>

  <Card title="Scatter Plot" icon="scatter-chart">
    Reveals correlations between two indicators across countries.
  </Card>

  <Card title="Heatmap" icon="table">
    Country × time grids — perfect for spotting patterns across many countries.
  </Card>

  <Card title="Stacked Area" icon="chart-area">
    Tracks composition and total simultaneously over time.
  </Card>
</CardGroup>

All 21 chart types are listed in the [Chart Types Guide](/features/chart-types).

## Step 4: Customize Your Chart

Use the settings panel on the right side to refine the visualization:

* **Date Range**: Set the start and end years. Historical data extends back 60+ years for many indicators.
* **Colors**: Choose from preset palettes or set custom country colors.
* **Labels**: Toggle country labels, data point markers, and value annotations.
* **Scale**: Switch between linear and logarithmic scales. Log scale is useful when comparing economies with very different sizes.
* **Chart Title**: Rename the chart to describe your specific analysis.

## Step 5: Generate AI Insights

Once you're viewing data, click the **AI Insights** button in the right panel to unlock expert-level analysis of your chart.

<Note>
  AI Insights are available on Pro and above. Free users see Quick Stats automatically.
</Note>

### Insight Tabs

| Tab                   | What It Does                                                                     | Available On |
| --------------------- | -------------------------------------------------------------------------------- | ------------ |
| **Quick Stats**       | Highlights the top/bottom values, trends, and volatility automatically           | All plans    |
| **Executive Summary** | 8–15 sentence professional briefing with inline citations and source attribution | Pro+         |
| **Analysis**          | Correlation detection, anomaly identification, regime changes                    | Pro+         |
| **Research**          | Curated secondary sources and academic context                                   | Pro+         |
| **Report**            | Comprehensive narrative report with all panels combined                          | Pro+         |
| **Forecast**          | Trend-based AI predictions for the next 1–5 years                                | Gold+        |

## Step 6: Save and Share

### Save Your Chart

1. Click **Save Chart** in the top toolbar
2. Give it a title and optional description
3. Add tags to organize by topic (e.g., "inflation", "BRICS", "2024")
4. Choose visibility: **Private** (My Space only) or **Publish** to the Community Gallery

### Share Options

* **Private Link**: Copy a shareable link from the chart toolbar — anyone with the link can view it
* **Publish to Community**: Make your chart visible in the public [Community Gallery](/features/community-gallery) — Pro and above
* **Embed**: Get an iframe embed code to place the chart on any website
* **Export**: Download as PNG, SVG, CSV, Excel (Pro+), JSON (Gold+), or PDF (Gold+)

## Your First Chart: A Walk-Through

Let's create a GDP comparison chart step by step:

1. **Search**: Type `GDP growth` in the search bar with Neural mode selected
2. **Select countries**: Click **G7** from the economic blocs panel
3. **Chart type**: Select **Line Chart** (the system will suggest this automatically)
4. **Date range**: Set 2010–2024
5. **Generate insights**: Click **AI Insights → Executive Summary** to get a written interpretation
6. **Save**: Click **Save Chart**, title it "G7 GDP Growth 2010-2024", and save to My Space

You've just created a professional economic data visualization in under two minutes.

## What's Available on Each Plan

| Feature                 | Free          | Pro     | Gold            | Enterprise      |
| ----------------------- | ------------- | ------- | --------------- | --------------- |
| Natural language search | 10/mo         | 50/mo   | 200/mo          | Unlimited       |
| Data sources            | 2             | 16+     | 16+             | 16+ + custom    |
| Chart types             | 5 basic       | 13      | All 21          | All 21          |
| AI Insights             | Quick Stats   | Full    | Full + Forecast | Full + Advanced |
| Saved charts            | —             | Yes     | Unlimited       | Unlimited       |
| Export formats          | PNG, SVG, CSV | + Excel | + JSON, PDF     | + API           |

## Common First-Time Questions

<AccordionGroup>
  <Accordion title="How do I search for a specific indicator code?">
    Switch to **Keyword** mode and type the indicator code directly (e.g., `NY.GDP.MKTP.CD` for World Bank GDP, or `CPIAUCSL` for FRED CPI). The exact-match search will find it immediately.
  </Accordion>

  <Accordion title="Can I add multiple indicators to one chart?">
    Yes — after your initial search, use the **Add Indicator** button in the settings panel to layer a second or third indicator. Dual-axis charts are automatically configured when the units are different.
  </Accordion>

  <Accordion title="What if I can't find the indicator I need?">
    Try rephrasing your search in Neural mode — for example, "consumer price index" instead of "inflation." You can also browse by category in **Indicators → Browse Categories** or search within the 50+ glossary terms.
  </Accordion>

  <Accordion title="How do I recreate a chart I saw in the Community Gallery?">
    Open the chart, click **View Details**, then click **Open in Dashboard**. This loads the same indicator and country configuration into a new chart session that you can customize.
  </Accordion>

  <Accordion title="Can I compare my chart data with someone else's?">
    Yes — use the **Country Comparison** feature (Pro and above) to load two country profiles side by side, or use the Macro Screener to rank all countries by any indicator and then open a multi-country chart from the results.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Chart Types Guide" icon="book" href="/guides/chart-indicator-guide">
    Learn about all 21 chart types and the indicators that pair best with each
  </Card>

  <Card title="Country Groups" icon="globe" href="/guides/country-groups">
    Master regional, income group, and economic bloc comparisons
  </Card>

  <Card title="Smart Search" icon="magnifying-glass" href="/features/smart-search">
    Power-user tips and AI search modes explained
  </Card>

  <Card title="AI Insights Guide" icon="sparkles" href="/features/insights">
    Deep dive into all insight agents — Summary, Analysis, Research, Forecast
  </Card>

  <Card title="Saving & Sharing" icon="share" href="/features/saving-sharing">
    Organize charts in My Space, share via link, and publish to the community
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Browse all 16+ sources and the 500,000+ indicators available
  </Card>
</CardGroup>