From 86b10b3598741648ecc8d1b9b262a716f978f1f4 Mon Sep 17 00:00:00 2001
From: Vincent Rubinetti <vince.rubinetti@gmail.com>
Date: Thu, 30 Jul 2026 11:58:05 -0400
Subject: [PATCH 1/8] add more info to cart

---
 frontend/src/api/api.ts        |  8 ++++----
 frontend/src/api/types.ts      |  2 ++
 frontend/src/pages/Cart.tsx    | 21 ++++++++++++++-------
 frontend/src/pages/Studies.tsx | 20 ++++++++++++++------
 frontend/src/state/cart.ts     |  7 +++++--
 5 files changed, 39 insertions(+), 19 deletions(-)

diff --git a/frontend/src/api/api.ts b/frontend/src/api/api.ts
index 72f070a..508bdd1 100644
--- a/frontend/src/api/api.ts
+++ b/frontend/src/api/api.ts
@@ -1,5 +1,5 @@
 import type { Feedback } from "@/api/types";
-import type { ShareCart } from "@/state/cart";
+import type { LocalCart, ShareCart } from "@/state/cart";
 import analytics from "react-ga4";
 import z from "zod";
 import { api, request } from "@/api";
@@ -122,7 +122,7 @@ export const shareCart = async (shareCart: ShareCart) => {
 
 /** download cart data */
 export const downloadCart = async (
-  ids: string[],
+  localCart: LocalCart,
   filename: string,
   type: string,
 ) => {
@@ -132,10 +132,10 @@ export const downloadCart = async (
   const options = {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: { ids },
+    body: { localCart },
     parse: "blob",
   } as const;
-  analytics.event("download_cart", { ids, filename, type });
+  analytics.event("download_cart", { localCart, filename, type });
   const data = await request(url, z.instanceof(Blob), options);
   if (type === "csv") downloadBlob(data, filename, "csv");
   if (type === "json") downloadBlob(data, filename, "json");
diff --git a/frontend/src/api/types.ts b/frontend/src/api/types.ts
index 7c72d7d..c601926 100644
--- a/frontend/src/api/types.ts
+++ b/frontend/src/api/types.ts
@@ -101,6 +101,8 @@ export const cart = z.object({
     z.object({
       id: z.string(),
       added: z.string(),
+      search: z.string(),
+      term: z.string(),
     }),
   ),
 });
diff --git a/frontend/src/pages/Cart.tsx b/frontend/src/pages/Cart.tsx
index 503484c..95e298a 100644
--- a/frontend/src/pages/Cart.tsx
+++ b/frontend/src/pages/Cart.tsx
@@ -264,7 +264,7 @@ export default function Cart() {
                         <>
                           <ActionButton
                             onClick={() =>
-                              downloadCart(studyIds, name || "cart", "csv")
+                              downloadCart(localCart, name || "cart", "csv")
                             }
                           >
                             <Table2 />
@@ -273,7 +273,7 @@ export default function Cart() {
 
                           <ActionButton
                             onClick={() =>
-                              downloadCart(studyIds, name || "cart", "json")
+                              downloadCart(localCart, name || "cart", "json")
                             }
                           >
                             <Braces />
@@ -409,9 +409,16 @@ export default function Cart() {
                       key: "database",
                       name: "Databases",
                       render: (database) =>
-                        Object.keys(database).map((database, index) => (
-                          <Database key={index} database={database} />
-                        )),
+                        Object.entries(database).map(
+                          ([database, { url, external_id }], index) => (
+                            <Database
+                              key={index}
+                              database={database}
+                              link={url || ""}
+                              externalId={external_id || ""}
+                            />
+                          ),
+                        ),
                     },
                     {
                       key: "added",
@@ -487,7 +494,7 @@ export default function Cart() {
               <Button
                 className="self-center"
                 onClick={() =>
-                  window.confirm("Clear created carts? Cannot be undone.") &&
+                  window.confirm("Clear created carts? No undo.") &&
                   clearCreatedCarts()
                 }
               >
@@ -513,7 +520,7 @@ function Clear({ size }: ClearProps) {
       color="accent"
       aria-disabled={!size}
       onClick={() => {
-        if (window.confirm("Clear cart? Cannot be undone.")) clearCart();
+        if (window.confirm("Clear cart? No undo.")) clearCart();
       }}
     >
       <Trash />
diff --git a/frontend/src/pages/Studies.tsx b/frontend/src/pages/Studies.tsx
index 54cf6f0..8762635 100644
--- a/frontend/src/pages/Studies.tsx
+++ b/frontend/src/pages/Studies.tsx
@@ -208,9 +208,9 @@ function Filters({
     <div className="flex w-60 flex-col gap-8 max-md:w-full max-md:flex-row max-md:flex-wrap max-md:items-start">
       {/* overview */}
       <dl className="w-full">
-        <dt className="text-sm text-stone-500">Raw Search</dt>
+        <dt className="text-sm text-stone-500">Search</dt>
         <dd className="text-sm text-stone-500">"{raw}"</dd>
-        <dt>Selection</dt>
+        <dt>Term</dt>
         <dd>
           {type && <Pill value={type} color={typeColor} />} {name} {term}
         </dd>
@@ -223,7 +223,7 @@ function Filters({
             className="w-full"
           />
         </dd>
-        <dt>Results</dt>
+        <dt>Studies</dt>
         <dd>{count ? formatNumber(count) : "-"}</dd>
 
         {!newSearch && (
@@ -359,7 +359,7 @@ function Results({ setParams, offset, limit, query }: ResultsProps) {
 
       {/* results */}
       {results.map((result, index) => (
-        <Result key={index} {...result} />
+        <Result key={index} query={query} {...result} />
       ))}
 
       {/* pagination */}
@@ -378,6 +378,7 @@ function Results({ setParams, offset, limit, query }: ResultsProps) {
 
 /** search result */
 function Result({
+  query,
   id,
   name,
   description,
@@ -389,10 +390,17 @@ function Result({
   classification,
   organisms,
   keywords,
-}: Study) {
+}: Study & { query: UseQueryResult<Studies> }) {
   /** current cart state */
   const cart = useAtomValue(cartAtom);
 
+  /** url search params state */
+  const [params] = useDebouncedParams();
+  const raw = params.get("raw") ?? "";
+
+  /** destructure query */
+  const { meta: { term = "" } = {} } = query.data ?? {};
+
   /** feedback for this study */
   const feedback = useAtomValue(feedbackAtom)[id];
 
@@ -571,7 +579,7 @@ function Result({
                 analytics.event("remove_from_cart", { id });
                 if (cartRef) fly(cartRef, event.currentTarget);
               } else {
-                addToCart(id);
+                addToCart(id, raw, term);
                 analytics.event("add_to_cart", { id });
                 if (cartRef) fly(event.currentTarget, cartRef);
               }
diff --git a/frontend/src/state/cart.ts b/frontend/src/state/cart.ts
index 33c6a88..73a25d7 100644
--- a/frontend/src/state/cart.ts
+++ b/frontend/src/state/cart.ts
@@ -24,11 +24,14 @@ export const inCart = (cart: LocalCart, study: string) =>
   cart?.studies.find((s) => s.id === study);
 
 /** add study id to cart */
-export const addToCart = (study: string) =>
+export const addToCart = (study: string, search: string, term: string) =>
   setAtom(cartAtom, (old) => ({
     ...old,
     studies: uniqBy(
-      [...old.studies, { id: study, added: new Date().toISOString() }],
+      [
+        ...old.studies,
+        { id: study, search, term, added: new Date().toISOString() },
+      ],
       "id",
     ),
   }));

From 465fc5be7d5810569d03cbe7846cbd7c75b289b2 Mon Sep 17 00:00:00 2001
From: Vincent Rubinetti <vince.rubinetti@gmail.com>
Date: Thu, 30 Jul 2026 12:08:36 -0400
Subject: [PATCH 2/8] rename "raw" to "search", "search/selection" to "term"

---
 frontend/src/App.tsx           |  2 +-
 frontend/src/api/api.ts        |  6 +++---
 frontend/src/pages/Home.tsx    | 26 +++++++++++++-------------
 frontend/src/pages/Studies.tsx | 28 ++++++++++++++--------------
 4 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 7c435bb..3855693 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -95,7 +95,7 @@ const routes = [
         },
       },
       {
-        path: "studies/:search?",
+        path: "studies/:term?",
         element: <Studies />,
       },
       {
diff --git a/frontend/src/api/api.ts b/frontend/src/api/api.ts
index 508bdd1..4f9342d 100644
--- a/frontend/src/api/api.ts
+++ b/frontend/src/api/api.ts
@@ -24,20 +24,20 @@ export const ontologySearch = async (search: string) => {
 
 /** search for studies and get full details */
 export const studySearch = async ({
-  search = "",
+  term = "",
   ordering = "",
   offset = 0,
   limit = 100,
   facets = {} as Record<string, string[]>,
 }) => {
   const url = new URL(`${api}/study/search/`);
-  url.searchParams.set("query", search);
+  url.searchParams.set("query", term);
   url.searchParams.set("ordering", ordering);
   url.searchParams.set("offset", String(offset));
   url.searchParams.set("limit", String(limit));
   for (const [facet, values] of Object.entries(facets))
     for (const value of values) url.searchParams.append(facet, value);
-  analytics.event("study_search", { search, ordering, facets });
+  analytics.event("study_search", { term, ordering, facets });
   const data = await request(url, studies);
   return data;
 };
diff --git a/frontend/src/pages/Home.tsx b/frontend/src/pages/Home.tsx
index b34aff5..7705fdc 100644
--- a/frontend/src/pages/Home.tsx
+++ b/frontend/src/pages/Home.tsx
@@ -229,25 +229,25 @@ export function SearchBox({ inputRef, className }: SearchBoxProps) {
   const navigate = useNavigate();
 
   /** search string state (immediate) */
-  const [_search, setSearch] = useState("");
+  const [_query, setQuery] = useState("");
 
-  /** search (debounced) */
-  const search = useDebounce(_search, 300);
+  /** search string state (debounced) */
+  const query = useDebounce(_query, 300);
 
   /** update search from url */
   const [params] = useSearchParams();
-  const raw = params.get("raw") ?? "";
-  const searchChanged = useChanged(raw);
-  if (searchChanged && raw) setSearch(raw);
+  const search = params.get("search") ?? "";
+  const searchChanged = useChanged(search);
+  if (searchChanged && search) setQuery(search);
 
   /** ontology search results */
   const ontologySearchQuery = useQuery({
-    queryKey: ["ontologySearch", search],
-    queryFn: () => ontologySearch(search),
+    queryKey: ["ontologySearch", query],
+    queryFn: () => ontologySearch(query),
   });
 
   /** search results */
-  const results = search.trim()
+  const results = query.trim()
     ? /** actual search results */
       (ontologySearchQuery.data?.map((result) => ({
         ...result,
@@ -271,8 +271,8 @@ export function SearchBox({ inputRef, className }: SearchBoxProps) {
   return (
     <Autocomplete
       inputRef={inputRef}
-      search={_search}
-      setSearch={setSearch}
+      search={_query}
+      setSearch={setQuery}
       placeholder="Search..."
       options={
         results.map(({ id, name, type, icon, performance }) => ({
@@ -305,11 +305,11 @@ export function SearchBox({ inputRef, className }: SearchBoxProps) {
         if (!result) return;
         addSearch(omit(result, "icon"));
         const params = new URLSearchParams();
-        params.set("raw", search || result.name);
+        params.set("search", query || result.name);
         navigate(`/studies/${id}?${params.toString()}`);
       }}
       status={
-        search.trim() &&
+        query.trim() &&
         showStatus({ query: ontologySearchQuery }) && (
           <Status query={ontologySearchQuery} className="contents!" />
         )
diff --git a/frontend/src/pages/Studies.tsx b/frontend/src/pages/Studies.tsx
index 8762635..390aed2 100644
--- a/frontend/src/pages/Studies.tsx
+++ b/frontend/src/pages/Studies.tsx
@@ -88,11 +88,11 @@ const orderingOptions = [
 type OrderingOption = (typeof orderingOptions)[number]["value"];
 
 export default function Studies() {
-  const { search = "" } = useParams<{ search: string }>();
+  const { term = "" } = useParams<{ term: string }>();
 
   /** url search params state */
   const [params, setParams, debouncedParams] = useDebouncedParams();
-  const raw = params.get("raw") ?? "";
+  const search = params.get("search") ?? "";
 
   /** new search button */
   const [newSearch, setNewSearch] = useState(false);
@@ -101,8 +101,8 @@ export default function Studies() {
     if (newSearch) searchRef.current?.focus();
   }, [newSearch]);
 
-  /** reset when search changes */
-  if (useChanged(search)) setNewSearch(false);
+  /** reset when term changes */
+  if (useChanged(term)) setNewSearch(false);
 
   /** ordering state from url params */
   const ordering =
@@ -131,13 +131,13 @@ export default function Studies() {
   delete facets.limit;
 
   /** page title */
-  const title = `${search} "${raw}"`;
+  const title = `${term} "${search}"`;
 
   /** search results */
   const studySearchQuery = useQuery({
-    queryKey: ["studySearch", search, ordering, offset, limit, facets],
+    queryKey: ["studySearch", term, ordering, offset, limit, facets],
     queryFn: () =>
-      studySearch({ search, ordering, offset, limit: Number(limit), facets }),
+      studySearch({ term, ordering, offset, limit: Number(limit), facets }),
     placeholderData: keepPreviousData,
   });
 
@@ -145,7 +145,7 @@ export default function Studies() {
     <>
       <Meta title={title} />
 
-      <H1 className="sr-only">Search results for "{search}"</H1>
+      <H1>Search results for "{term}"</H1>
 
       <section className="width-lg">
         <div className="grid grid-cols-[auto_1fr] gap-12 *:min-w-0 max-md:grid-cols-1">
@@ -156,7 +156,7 @@ export default function Studies() {
           )}
 
           <Filters
-            raw={raw}
+            search={search}
             params={params}
             setParams={setParams}
             newSearch={newSearch}
@@ -178,7 +178,7 @@ export default function Studies() {
 }
 
 type FiltersProps = {
-  raw: string;
+  search: string;
   params: URLSearchParams;
   setParams: ReturnType<typeof useDebouncedParams>[1];
   newSearch: boolean;
@@ -189,7 +189,7 @@ type FiltersProps = {
 
 /** filters panel */
 function Filters({
-  raw,
+  search,
   params,
   setParams,
   newSearch,
@@ -209,7 +209,7 @@ function Filters({
       {/* overview */}
       <dl className="w-full">
         <dt className="text-sm text-stone-500">Search</dt>
-        <dd className="text-sm text-stone-500">"{raw}"</dd>
+        <dd className="text-sm text-stone-500">"{search}"</dd>
         <dt>Term</dt>
         <dd>
           {type && <Pill value={type} color={typeColor} />} {name} {term}
@@ -396,7 +396,7 @@ function Result({
 
   /** url search params state */
   const [params] = useDebouncedParams();
-  const raw = params.get("raw") ?? "";
+  const search = params.get("search") ?? "";
 
   /** destructure query */
   const { meta: { term = "" } = {} } = query.data ?? {};
@@ -579,7 +579,7 @@ function Result({
                 analytics.event("remove_from_cart", { id });
                 if (cartRef) fly(cartRef, event.currentTarget);
               } else {
-                addToCart(id, raw, term);
+                addToCart(id, search, term);
                 analytics.event("add_to_cart", { id });
                 if (cartRef) fly(event.currentTarget, cartRef);
               }

From 21209981db6df27399779a4823b94e8ab5d44eb7 Mon Sep 17 00:00:00 2001
From: Faisal Alquaddoomi <faisal.alquaddoomi@cuanschutz.edu>
Date: Thu, 30 Jul 2026 13:05:18 -0600
Subject: [PATCH 3/8] Adds search, term fields to CartItem

---
 .../0057_cartitem_search_cartitem_term.py     | 23 +++++++++++++++++++
 backend/src/api/models.py                     |  6 +++++
 backend/src/api/serializers.py                | 11 +++++++--
 3 files changed, 38 insertions(+), 2 deletions(-)
 create mode 100644 backend/src/api/migrations/0057_cartitem_search_cartitem_term.py

diff --git a/backend/src/api/migrations/0057_cartitem_search_cartitem_term.py b/backend/src/api/migrations/0057_cartitem_search_cartitem_term.py
new file mode 100644
index 0000000..9ac54ef
--- /dev/null
+++ b/backend/src/api/migrations/0057_cartitem_search_cartitem_term.py
@@ -0,0 +1,23 @@
+# Generated by Django 5.2.7 on 2026-07-30 18:45
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api', '0056_sitestatistic'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='cartitem',
+            name='search',
+            field=models.CharField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='cartitem',
+            name='term',
+            field=models.CharField(blank=True, null=True),
+        ),
+    ]
diff --git a/backend/src/api/models.py b/backend/src/api/models.py
index bcc698a..044a1c0 100644
--- a/backend/src/api/models.py
+++ b/backend/src/api/models.py
@@ -870,6 +870,12 @@ class CartItem(models.Model):
 
     series = models.ForeignKey(GEOSeries, on_delete=models.CASCADE)
     added_at = models.DateTimeField(null=True, blank=True)
+
+    # the user's query at the time of adding to the cart
+    search = models.CharField(null=True, blank=True)
+    # the ontology term that they selected at the time of adding to the cart
+    term = models.CharField(null=True, blank=True)
+
     cart = models.ForeignKey(
         "Cart", null=True, blank=True, on_delete=models.CASCADE, related_name="items"
     )
diff --git a/backend/src/api/serializers.py b/backend/src/api/serializers.py
index b1d5e25..8c86db2 100644
--- a/backend/src/api/serializers.py
+++ b/backend/src/api/serializers.py
@@ -315,12 +315,19 @@ class DatabaseStatsSerializer(serializers.Serializer):
 class CartItemSerializer(serializers.ModelSerializer):
     """Serializer for CartItem model."""
 
-    id = serializers.CharField(source="series.series_id", read_only=True)
+    id = serializers.CharField(source="series.gse", read_only=True)
+    search = serializers.CharField(read_only=True)
+    term = serializers.CharField(read_only=True)
     added = serializers.DateTimeField(source="added_at", read_only=True)
 
     class Meta:
         model = CartItem
-        fields = ["id", "added"]
+        fields = [
+            "id",
+            "search",
+            "term",
+            "added"
+        ]
 
 
 class CartSerializer(serializers.ModelSerializer):

From 2a5bf9bf76f35c444cc190f09b1daaa3f018291b Mon Sep 17 00:00:00 2001
From: Faisal Alquaddoomi <faisal.alquaddoomi@cuanschutz.edu>
Date: Thu, 30 Jul 2026 13:06:40 -0600
Subject: [PATCH 4/8] Adds search, term to create method on CartItem view

---
 backend/src/api/views.py | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/backend/src/api/views.py b/backend/src/api/views.py
index 2e17d85..a0219f8 100644
--- a/backend/src/api/views.py
+++ b/backend/src/api/views.py
@@ -680,16 +680,19 @@ def create(self, request, *args, **kwargs):
         {
             "studies": [
                 {
-                "id": "GSE35357",
-                "added": "2025-12-12T11:21:35.895Z"
+                    "search": "Hepatocyte",
+                    "term": "CL:0000182",
+                    "added": "2026-07-30T18:46:33.885000Z"
                 },
                 {
-                "id": "GSE149008",
-                "added": "2025-12-12T11:21:36.627Z"
+                    "search": "Hepatocyte",
+                    "term": "CL:0000182",
+                    "added": "2026-07-30T18:46:34.551000Z"
                 },
                 {
-                "id": "GSE45968",
-                "added": "2025-12-12T11:21:37.293Z"
+                    "search": "Hepatocyte",
+                    "term": "CL:0000182",
+                    "added": "2026-07-30T18:46:35.153000Z"
                 }
             ],
             "name": "yowza"
@@ -705,10 +708,18 @@ def create(self, request, *args, **kwargs):
             # create CartItem objects for each series
             for series_data in series_list:
                 series_id = series_data["id"]
+                search = series_data.get("search")
+                term = series_data.get("term")
                 added_at = series_data.get("added")
                 try:
                     series = GEOSeries.objects.get(gse=series_id)
-                    CartItem.objects.create(series=series, added_at=added_at, cart=cart)
+                    CartItem.objects.create(
+                        series=series,
+                        search=search,
+                        term=term,
+                        added_at=added_at,
+                        cart=cart
+                    )
                 except GEOSeries.DoesNotExist:
                     continue  # skip invalid series ids
 

From 1804d8a04ee4a8053ec75c338959856af8d93326 Mon Sep 17 00:00:00 2001
From: Faisal Alquaddoomi <faisal.alquaddoomi@cuanschutz.edu>
Date: Thu, 30 Jul 2026 13:06:51 -0600
Subject: [PATCH 5/8] Removes download endpoint from Cart view

---
 backend/src/api/views.py | 67 ----------------------------------------
 1 file changed, 67 deletions(-)

diff --git a/backend/src/api/views.py b/backend/src/api/views.py
index a0219f8..519d35c 100644
--- a/backend/src/api/views.py
+++ b/backend/src/api/views.py
@@ -725,70 +725,3 @@ def create(self, request, *args, **kwargs):
 
             serializer = self.get_serializer(cart)
             return Response(serializer.data, status=status.HTTP_201_CREATED)
-
-    # provide a /download action to download cart contents
-    @action(
-        detail=False,
-        methods=["post"],
-        url_path="download",
-        permission_classes=[AllowAny],
-    )
-    def download(self, request):
-        """
-        API endpoint for downloading cart contents.
-
-        Expects a JSON body with the following structure:
-        {
-            "ids": [
-                "GSE35357",
-                "GSE149008",
-                "GSE45968"
-            ]
-        }
-
-        Query parameters:
-        - type (optional): 'json' or 'csv' (default: 'json')
-        - filename (optional): desired filename (default: 'cart_download')
-        """
-        series_ids = request.data.get("ids", [])
-        download_type = request.query_params.get("type", "json")
-        filename = request.query_params.get("filename", "cart_download")
-
-        series_qs = GEOSeries.objects.filter(gse__in=series_ids)
-
-        if download_type == "json":
-            # prepare JSON response
-            data = {
-                "studies": [
-                    {
-                        "id": series.gse,
-                        "title": series.title,
-                        "summary": series.summary,
-                    }
-                    for series in series_qs
-                ]
-            }
-            response = Response(data, content_type="application/json")
-            response["Content-Disposition"] = f'attachment; filename="{filename}.json"'
-            return response
-
-        elif download_type == "csv":
-            # prepare CSV response
-            response = HttpResponse(content_type="text/csv; charset=utf-8")
-            response["Content-Disposition"] = f'attachment; filename="{filename}.csv"'
-
-            # Helps Excel correctly detect UTF-8
-            response.write("\ufeff")
-
-            writer = csv.writer(response)
-            writer.writerow(["GEOSeries ID", "Title", "Summary"])
-            for series in series_qs:
-                writer.writerow([series.gse, series.title, series.summary])
-
-            return response
-
-        else:
-            return Response(
-                {"error": "Unsupported download type"},
-                status=status.HTTP_400_BAD_REQUEST,
-            )

From 4d7ff1a055289f390b44b08ba758679a1e7593bb Mon Sep 17 00:00:00 2001
From: Vincent Rubinetti <vince.rubinetti@gmail.com>
Date: Thu, 30 Jul 2026 17:33:35 -0400
Subject: [PATCH 6/8] add cart download to frontend

---
 frontend/src/api/api.ts        | 24 +--------
 frontend/src/pages/Cart.tsx    | 91 ++++++++++++++++++++++++----------
 frontend/src/pages/Studies.tsx |  1 -
 frontend/src/util/download.ts  | 43 +++++++++++++---
 4 files changed, 103 insertions(+), 56 deletions(-)

diff --git a/frontend/src/api/api.ts b/frontend/src/api/api.ts
index 4f9342d..d1b3cb0 100644
--- a/frontend/src/api/api.ts
+++ b/frontend/src/api/api.ts
@@ -1,10 +1,9 @@
 import type { Feedback } from "@/api/types";
-import type { LocalCart, ShareCart } from "@/state/cart";
+import type { ShareCart } from "@/state/cart";
 import analytics from "react-ga4";
 import z from "zod";
 import { api, request } from "@/api";
 import { cart, ontologies, samples, stats, studies } from "@/api/types";
-import { downloadBlob } from "@/util/download";
 
 /** get project wide stats */
 export const getStats = async () => {
@@ -119,24 +118,3 @@ export const shareCart = async (shareCart: ShareCart) => {
   const data = await request(url, cart, options);
   return data;
 };
-
-/** download cart data */
-export const downloadCart = async (
-  localCart: LocalCart,
-  filename: string,
-  type: string,
-) => {
-  const url = new URL(`${api}/cart/download/`);
-  url.searchParams.set("type", type);
-  url.searchParams.set("filename", filename);
-  const options = {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: { localCart },
-    parse: "blob",
-  } as const;
-  analytics.event("download_cart", { localCart, filename, type });
-  const data = await request(url, z.instanceof(Blob), options);
-  if (type === "csv") downloadBlob(data, filename, "csv");
-  if (type === "json") downloadBlob(data, filename, "json");
-};
diff --git a/frontend/src/pages/Cart.tsx b/frontend/src/pages/Cart.tsx
index 95e298a..8626cd7 100644
--- a/frontend/src/pages/Cart.tsx
+++ b/frontend/src/pages/Cart.tsx
@@ -2,11 +2,12 @@ import type { ColumnSort } from "@tanstack/react-table";
 import type { Cart } from "@/api/types";
 import type { Limit } from "@/components/Pagination";
 import { useEffect, useState } from "react";
+import analytics from "react-ga4";
 import { useParams } from "react-router";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import clsx from "clsx";
 import { useAtomValue } from "jotai";
-import { sum } from "lodash";
+import { omit, sum } from "lodash";
 import {
   ArrowRight,
   Braces,
@@ -20,12 +21,7 @@ import {
   Table2,
   Trash,
 } from "lucide-react";
-import {
-  cartLookup,
-  downloadCart,
-  shareCart,
-  studyBatchLookup,
-} from "@/api/api";
+import { cartLookup, shareCart, studyBatchLookup } from "@/api/api";
 import { makeDataset } from "@/api/refine.bio";
 import ActionButton, { copy } from "@/components/ActionButton";
 import Ago from "@/components/Ago";
@@ -49,6 +45,7 @@ import {
   createdCartsAtom,
   removeFromCart,
 } from "@/state/cart";
+import { downloadCsv, downloadJson, downloadTsv } from "@/util/download";
 import { formatNumber } from "@/util/string";
 
 export default function Cart() {
@@ -109,7 +106,13 @@ export default function Cart() {
   if (!size) queryClient.resetQueries({ queryKey: ["studyBatchLookup"] });
 
   /** full study details */
-  const studyDetails = studyBatchLookupQuery.data?.results || [];
+  const studyDetails = (studyBatchLookupQuery.data?.results || []).map(
+    (study) => ({
+      ...study,
+      /** merge in any details from local cart */
+      ...localCart?.studies.find((s) => !shared && s.id === study.id),
+    }),
+  );
 
   /** page title */
   const title = shared ? `Shared cart "${name}"` : `Data Cart`;
@@ -163,6 +166,50 @@ export default function Cart() {
   /** user self-identification */
   const { userEmail, setUserEmail } = useUser();
 
+  /** download cart in particular format */
+  const downloadCart = (type: string) => {
+    analytics.event("download_cart", studyDetails);
+
+    const filename = name || "cart";
+
+    if (type === "json")
+      return downloadJson(
+        studyDetails.map((study) => omit(study, ["feedback"])),
+        filename,
+      );
+
+    const table = [
+      [
+        "ID",
+        "Search",
+        "Term",
+        "Name",
+        "Description",
+        "Sample Count",
+        "Confidence",
+        "Databases",
+        "Platform",
+        "Organisms",
+        "Classification",
+      ],
+      ...studyDetails.map((study) => [
+        study.id,
+        study.search,
+        study.term,
+        study.name,
+        study.description,
+        study.sample_count,
+        study.confidence.name,
+        Object.keys(study.database).join(", "),
+        study.platform.join(", "),
+        study.organisms.join(", "),
+        study.classification,
+      ]),
+    ];
+    if (type === "csv") downloadCsv(table, filename);
+    if (type === "tsv") downloadTsv(table, filename);
+  };
+
   return (
     <>
       <Meta title={title} />
@@ -262,23 +309,20 @@ export default function Cart() {
                     <Popover
                       content={
                         <>
-                          <ActionButton
-                            onClick={() =>
-                              downloadCart(localCart, name || "cart", "csv")
-                            }
-                          >
+                          <Button onClick={() => downloadCart("csv")}>
                             <Table2 />
                             CSV
-                          </ActionButton>
+                          </Button>
+
+                          <Button onClick={() => downloadCart("tsv")}>
+                            <Table2 />
+                            TSV
+                          </Button>
 
-                          <ActionButton
-                            onClick={() =>
-                              downloadCart(localCart, name || "cart", "json")
-                            }
-                          >
+                          <Button onClick={() => downloadCart("json")}>
                             <Braces />
                             JSON
-                          </ActionButton>
+                          </Button>
                         </>
                       }
                     >
@@ -436,12 +480,7 @@ export default function Cart() {
                       ),
                     },
                   ]}
-                  rows={studyDetails.map((study) => ({
-                    ...study,
-                    added:
-                      localCart?.studies.find((s) => s.id === study.id)
-                        ?.added ?? "2025-01-01T00:00:00.000Z",
-                  }))}
+                  rows={studyDetails}
                   sort={ordering}
                   onSort={setOrdering}
                   page={offset}
diff --git a/frontend/src/pages/Studies.tsx b/frontend/src/pages/Studies.tsx
index 390aed2..161c955 100644
--- a/frontend/src/pages/Studies.tsx
+++ b/frontend/src/pages/Studies.tsx
@@ -124,7 +124,6 @@ export default function Studies() {
       debouncedParams.getAll(key),
     ]),
   );
-  console.log(facets);
   /** exclude param keywords */
   delete facets.ordering;
   delete facets.offset;
diff --git a/frontend/src/util/download.ts b/frontend/src/util/download.ts
index 20d91ee..eac48c8 100755
--- a/frontend/src/util/download.ts
+++ b/frontend/src/util/download.ts
@@ -41,10 +41,41 @@ const getUrl = (
         data instanceof Blob ? data : new Blob([data], { type }),
       );
 
-/** download blob as file */
-export const downloadBlob = (data: Blob, filename: string, ext: string) =>
-  download(getUrl(data), filename, ext);
+/** download data as json file */
+export const downloadJson = (data: unknown, filename: string) =>
+  download(
+    getUrl(JSON.stringify(data, null, 2), "application/json;charset=utf-8"),
+    filename,
+    "json",
+  );
 
-/** download string as text file */
-export const downloadTxt = (data: string, filename: string) =>
-  download(getUrl(data, "text/plain;charset=utf-8"), filename, "txt");
+type Table = (string | number | boolean | null | undefined)[][];
+
+/** assemble csv/tsv from arrays */
+const stringifyTable = (table: Table, delimiter = "\t") =>
+  table
+    .map((row) =>
+      row
+        .map((col) => (col === null || col === undefined ? "" : String(col)))
+        .join(delimiter),
+    )
+    .join("\n");
+
+/** download data as csv file */
+export const downloadCsv = (data: Table, filename: string) =>
+  download(
+    getUrl(stringifyTable(data, ","), "text/csv;charset=utf-8"),
+    filename,
+    "csv",
+  );
+
+/** download data as tsv file */
+export const downloadTsv = (data: Table, filename: string) =>
+  download(
+    getUrl(
+      stringifyTable(data, "\t"),
+      "text/tab-separated-values;charset=utf-8",
+    ),
+    filename,
+    "tsv",
+  );

From d5592933b5e9c384560bb8f075dd79342f2b9180 Mon Sep 17 00:00:00 2001
From: Vincent Rubinetti <vince.rubinetti@gmail.com>
Date: Fri, 7 Aug 2026 14:14:30 -0400
Subject: [PATCH 7/8] add database external ids to cart download

---
 frontend/src/pages/Cart.tsx | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/frontend/src/pages/Cart.tsx b/frontend/src/pages/Cart.tsx
index 8626cd7..7c56ce4 100644
--- a/frontend/src/pages/Cart.tsx
+++ b/frontend/src/pages/Cart.tsx
@@ -7,7 +7,7 @@ import { useParams } from "react-router";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import clsx from "clsx";
 import { useAtomValue } from "jotai";
-import { omit, sum } from "lodash";
+import { omit, sum, uniq } from "lodash";
 import {
   ArrowRight,
   Braces,
@@ -178,6 +178,12 @@ export default function Cart() {
         filename,
       );
 
+    /** unique list of databases */
+    const databases = uniq(
+      studyDetails.flatMap((study) => Object.keys(study.database)),
+    );
+
+    /** format data into table */
     const table = [
       [
         "ID",
@@ -187,10 +193,10 @@ export default function Cart() {
         "Description",
         "Sample Count",
         "Confidence",
-        "Databases",
         "Platform",
         "Organisms",
         "Classification",
+        ...databases,
       ],
       ...studyDetails.map((study) => [
         study.id,
@@ -200,12 +206,15 @@ export default function Cart() {
         study.description,
         study.sample_count,
         study.confidence.name,
-        Object.keys(study.database).join(", "),
         study.platform.join(", "),
         study.organisms.join(", "),
         study.classification,
+        ...databases.map(
+          (database) => study.database[database]?.external_id || "",
+        ),
       ]),
     ];
+
     if (type === "csv") downloadCsv(table, filename);
     if (type === "tsv") downloadTsv(table, filename);
   };

From 83709f6d0525586d71bb4de6b458d16533e941d3 Mon Sep 17 00:00:00 2001
From: Vincent Rubinetti <vince.rubinetti@gmail.com>
Date: Fri, 7 Aug 2026 14:19:43 -0400
Subject: [PATCH 8/8] add check marks to dbs in cart download

---
 frontend/src/pages/Cart.tsx | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/frontend/src/pages/Cart.tsx b/frontend/src/pages/Cart.tsx
index 7c56ce4..ecb05fd 100644
--- a/frontend/src/pages/Cart.tsx
+++ b/frontend/src/pages/Cart.tsx
@@ -209,8 +209,13 @@ export default function Cart() {
         study.platform.join(", "),
         study.organisms.join(", "),
         study.classification,
-        ...databases.map(
-          (database) => study.database[database]?.external_id || "",
+        ...databases.map((database) =>
+          [
+            study.database[database] ? "✓" : "✗",
+            study.database[database]?.external_id || "",
+          ]
+            .filter(Boolean)
+            .join(" "),
         ),
       ]),
     ];