diff --git a/README.md b/README.md index dcdf4c1..2bad658 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Find and replace all on all files (CMD+SHIFT+F): - Description: A Nuxt module to fetch and display user country information --> -# User Country Module +# User Country Detect [![npm version][npm-version-src]][npm-version-href] [![npm downloads][npm-downloads-src]][npm-downloads-href] @@ -15,18 +15,6 @@ Find and replace all on all files (CMD+SHIFT+F): [![Nuxt][nuxt-src]][nuxt-href] A Nuxt module to fetch and display user country information. - -## Why Use This Module? - -When compared to other free alternatives, this module stands out because: - - **It's really fast:** With an average global latency of just 25ms, it's one of the fastest options available. - - **Effective localization suggestions:** It works well to suggest changing the user's country or language/currency based on their location, making it ideal for enhancing the user experience. - - **No browser location sharing required:** Unlike some other solutions, it doesn't require the user to share their precise browser location, ensuring better privacy while still delivering accurate information. - - - - - ## Features @@ -35,18 +23,6 @@ When compared to other free alternatives, this module stands out because: - πŸ—ΊοΈ  Supports 250 countries, autonomous regions, ... - ⚑  Extremely fast detection and response time. -## Free API service -The module bases its detection on a network of 119 PoP, with an average global latency of 25ms. The API is offered by JAMflow.cloud and is free to use, without any guarantee. We will limit IP or website that will spam or abuse the service. - -### Commercial use -You are allowed to use the service for any commercial use, but you are not allowed to resell it without an agreement with us beforehand. - -### API Rate Limit - -We limit requests to 3 requests per second per IP address. If you need a higher rate limit, please contact us. - -### - ## Quick Setup Install the module to your Nuxt application with one command: @@ -86,6 +62,31 @@ const { data, refresh, status } = await useUserCountry(); - `refresh`: Function to refresh the country information. - `status`: The status of the fetch request (`'idle'`, `'loading'`, `'success'`, `'error'`). +## Why Use This Module? + +When compared to other free alternatives, this module stands out because: + - **Focuses on performance:** With an average global latency of just 25ms, it's one of the fastest options available. + - **Effective localization suggestions:** It works well to suggest changing the user's country or language/currency based on their location, making it ideal for enhancing the user experience. + - **No browser location sharing required:** Unlike some other solutions, it doesn't require the user to share their precise browser location, ensuring better privacy while still delivering accurate information. + + + + + + +## Free API service +The module bases its detection on a network of 119 PoP, with an average global latency of 25ms. The API is offered by JAMflow.cloud and is free to use, without any guarantee currently. We will limit IP or website that will spam or abuse the service. + +### Commercial use +You are allowed to use the service for any commercial use, but you are not allowed to resell it without an agreement with us beforehand. + +### API Rate Limit + +We limit requests to 3 requests per second per IP address. If you need a higher rate limit, please contact us. + +### + + ## Contribution