---
format:
  html:
    toc: true
    page-layout: custom
execute:
  echo: false
  eval: true
  freeze: auto
  cache: false
  warning: false
  message: false
  include: true
  # ENABLE inline R code evaluation
  inline: true
resources:
  - figures/
---

```{r setup, include=FALSE}
library(floraR)

ffb_versions <- tryCatch(
  flora_version(),
  error = function(e) NULL
)

if (!is.null(ffb_versions) && nrow(ffb_versions) > 0) {
  latest_row     <- ffb_versions[ffb_versions$Latest %in% TRUE, ]
  if (nrow(latest_row) == 0) latest_row <- ffb_versions[1, ]
  n_versions     <- nrow(ffb_versions)
  latest_version <- latest_row$Version[1]
  # flora_version() returns counts as text with thousands separators
  # (e.g. "165,841"), which as.numeric() cannot parse on its own
  n_records      <- suppressWarnings(as.numeric(gsub("[^0-9]", "", latest_row$Records[1])))
  latest_records <- if (is.na(n_records)) NA else format(n_records, big.mark = ",")
  latest_date    <- latest_row$Published_on[1]
} else {
  n_versions     <- NA
  latest_version <- NA
  latest_records <- NA
  latest_date    <- NA
}
```

<style>
  .floating-logos {
    position: fixed;
    top: 60px;
    right: 450px;
    width: 165px;
    opacity: 0.85;
    z-index: 1;
  }

  .floating-logos img {
    display: block;
    width: 100%;
    margin-bottom: 12px;
    border-radius: 4px;
  }
</style>

<div class="floating-logos">
  <img src='/figures/floraR_hex_sticker.png' alt='floraR hex sticker'>
  <img src='/figures/jbrj_marca.jpg' alt='JBRJ logo'>
</div>

::: whitebox
::: {style="padding-left: 100px; padding-right: 50px; display: inline-block;"}

::: {layout-ncol="2"}

::: {style="text-align: left;"}

\
`floraR` is an R package for accessing, analyzing, and curating taxonomic and distributional data on plants and algae from the [Flora e Funga do Brasil (FFB)](https://floradobrasil.jbrj.gov.br/consulta/) platform, maintained by the [Rio de Janeiro Botanical Garden](https://www.gov.br/jbrj/pt-br). It provides a comprehensive interface to download, parse, filter, and explore checklist data from the FFB IPT data portal — from browsing by taxonomic, geographic, or trait criteria to resolving your own species name lists against it.\
\
But `floraR` is designed to do more than retrieve data from FFB: it is meant to help taxonomists expand the current FFB monographs. By cross-checking FFB against global resources - the species distributions of [Plants of the World Online](https://powo.science.kew.org) and the type specimens collected in Brazil that herbaria publish through [GBIF](https://www.gbif.org) - it points to species that are recorded in Brazil but not yet treated in FFB, giving specialists a concrete starting point for bringing each monograph closer to a complete account of the Brazilian flora.\
\

```{=html}
<div class="stat-strip">
  <div class="stat-card">
    <span class="stat-number">`r ifelse(is.na(n_versions), "—", n_versions)`</span>
    <span class="stat-label">FFB dataset versions published</span>
  </div>
  <div class="stat-card">
    <span class="stat-number">`r ifelse(is.na(latest_version), "—", latest_version)`</span>
    <span class="stat-label">Latest version</span>
  </div>
  <div class="stat-card">
    <span class="stat-number">`r ifelse(is.na(latest_records), "—", latest_records)`</span>
    <span class="stat-label">Records in latest release</span>
  </div>
  <div class="stat-card">
    <span class="stat-number">`r ifelse(is.na(latest_date), "—", latest_date)`</span>
    <span class="stat-label">Published on</span>
  </div>
</div>
```

These figures are retrieved live from the FFB IPT metadata via `flora_version()` every time this page is built — the same call you would run yourself before deciding which dataset version to work with.\
\

## Flora e Funga do Brasil

Brazil harbors the richest plant, algal, and fungal diversity in the world ([BFG 2022](https://doi.org/10.1002/tax.12640)). Assembling a complete, continuously updated checklist of this diversity has been a decades-long collaborative effort involving hundreds of taxonomists across the country.

The project began in 2008 as the *Lista de Espécies da Flora do Brasil*, a first attempt to compile a national species checklist validated by specialists. It evolved into [Flora do Brasil 2020](http://doi.org/10.47871/jbrj2021004), launched to meet Brazil's commitments under the Global Strategy for Plant Conservation of the Convention on Biological Diversity, and — following the incorporation of fungi — into its current form, [Flora e Funga do Brasil](https://floradobrasil.jbrj.gov.br/consulta/).

For each accepted name, the checklist records nomenclatural status (accepted, synonym, or doubtful), taxonomic classification, geographic distribution across Brazilian states and phytogeographic domains, endemism status, life form, habitat, and vegetation type. This structured, validated backbone underpins taxonomic research, conservation assessments, and biodiversity informatics across the country, and is also the nomenclatural reference used to validate specimen images published on the [Reflora Virtual Herbarium](https://floradobrasil.jbrj.gov.br/reflora/herbarioVirtual/ConsultaPublicoHVUC/ConsultaPublicoHVUC.do).

Data are published as versioned Darwin Core Archives through the [FFB IPT Data Portal](https://ipt.jbrj.gov.br/jbrj/resource?r=lista_especies_flora_brasil), hosted by the [Rio de Janeiro Botanical Garden (JBRJ)](https://www.gov.br/jbrj/pt-br). `floraR` reads directly from this portal, so every result reflects the checklist as curated by the taxonomist community at the time of the query.

If you are a taxonomist and wish to contribute new names, updates, or corrections to Flora e Funga do Brasil, see the [contribution guidelines](https://floradobrasil.jbrj.gov.br/consulta/) on the platform itself, or contact the FFB coordination team at **floraefungadobrasil\@jbrj.gov.br**.\
\
:::
::: {style="display: flex; gap: 16px; justify-content: center; align-items: center;"}
:::
:::
:::
:::

::: mainbox
::: {style="padding-left: 100px; padding-right: 100px; display: inline-block;"}
::: {layout-ncol="2"}
::: {style="text-align: center;"}
### [Get Started](/get-started/index.qmd)

Welcome new users! Start learning how to install `floraR`
:::

::: {style="text-align: center;"}
### [Articles](/articles/index.qmd)

"How-to" articles to help you learn how to use `floraR`
:::
:::
:::
:::

:::