feat: add country flags to dashboard

components/dashboard/Countries.tsx

@@ -1,6 +1,7 @@
 'use client'
 
 import { formatNumber } from '@/lib/utils/format'
+import * as Flags from 'country-flag-icons/react/3x2'
 
 interface CountriesProps {
   countries: Array<{ country: string; pageviews: number }>
@@ -18,6 +19,14 @@ export default function Countries({ countries }: CountriesProps) {
     )
   }
 
+  const getFlagComponent = (countryCode: string) => {
+    if (!countryCode || countryCode === 'Unknown') return null
+    // * The API returns 2-letter country codes (e.g. US, DE)
+    // * We cast it to the flag component name
+    const FlagComponent = (Flags as any)[countryCode]
+    return FlagComponent ? <FlagComponent className="w-5 h-5 rounded-sm shadow-sm" /> : null
+  }
+
   return (
     <div className="bg-white dark:bg-neutral-900 border border-neutral-200 dark:border-neutral-800 rounded-xl p-6">
       <h3 className="text-lg font-semibold mb-4 text-neutral-900 dark:text-white">
@@ -26,8 +35,9 @@ export default function Countries({ countries }: CountriesProps) {
       <div className="space-y-3">
         {countries.map((country, index) => (
           <div key={index} className="flex items-center justify-between">
-            <div className="flex-1 truncate text-neutral-900 dark:text-white">
-              {country.country}
+            <div className="flex-1 truncate text-neutral-900 dark:text-white flex items-center gap-3">
+              <span className="shrink-0">{getFlagComponent(country.country)}</span>
+              <span className="truncate">{country.country === 'Unknown' ? 'Unknown' : country.country}</span>
             </div>
             <div className="text-sm font-semibold text-neutral-600 dark:text-neutral-400 ml-4">
               {formatNumber(country.pageviews)}

package-lock.json

@@ -11,6 +11,7 @@
         "@ciphera-net/ui": "^0.0.6",
         "@radix-ui/react-icons": "^1.3.2",
         "axios": "^1.13.2",
+        "country-flag-icons": "^1.6.4",
         "framer-motion": "^12.23.26",
         "next": "^16.1.1",
         "next-themes": "^0.4.6",
@@ -2644,6 +2645,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/country-flag-icons": {
+      "version": "1.6.4",
+      "resolved": "https://registry.npmjs.org/country-flag-icons/-/country-flag-icons-1.6.4.tgz",
+      "integrity": "sha512-Z3Zi419FI889tlElMsVhCIS5eRkiLDWixr576J5DPiTe5RGxpbRi+enMpHdYVp5iK5WFjr8P/RgyIFAGhFsiFg==",
+      "license": "MIT"
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -3399,6 +3406,7 @@
       "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@rtsao/scc": "^1.1.0",
         "array-includes": "^3.1.9",

package.json

@@ -13,6 +13,7 @@
     "@ciphera-net/ui": "^0.0.6",
     "@radix-ui/react-icons": "^1.3.2",
     "axios": "^1.13.2",
+    "country-flag-icons": "^1.6.4",
     "framer-motion": "^12.23.26",
     "next": "^16.1.1",
     "next-themes": "^0.4.6",