@tanstack/create 0.61.4 → 0.61.6

package/dist/frameworks/react/add-ons/strapi/assets/src/routes/demo/strapi.tsx

@@ -1,64 +1,290 @@
-import { articles } from '#/lib/strapiClient'
 import { createFileRoute, Link } from '@tanstack/react-router'
+import { z } from 'zod'
+import { strapiApi } from '@/data/loaders'
+import { StrapiImage } from '@/components/strapi-image'
+import { Search } from '@/components/search'
+import { Pagination } from '@/components/pagination'
+import type { TArticle } from '@/types/strapi'
+
+type LoaderResult = {
+  status: 'success' | 'empty' | 'error'
+  articles: TArticle[]
+  meta?: { pagination?: { page: number; pageCount: number; total: number } }
+  error?: string
+  query?: string
+}
+
+const searchSchema = z.object({
+  query: z.string().optional(),
+  page: z.number().default(1),
+})
 
 export const Route = createFileRoute('/demo/strapi')({
   component: RouteComponent,
-  loader: async () => {
-    const { data: strapiArticles } = await articles.find()
-    return strapiArticles
+  validateSearch: searchSchema,
+  loaderDeps: ({ search }) => ({ search }),
+  loader: async ({ deps }): Promise<LoaderResult> => {
+    const { query, page } = deps.search
+    try {
+      const response = await strapiApi.articles.getArticlesData({
+        data: { query, page },
+      })
+
+      // Check if we got data
+      if (!response || !response.data) {
+        return {
+          status: 'empty',
+          articles: [],
+          meta: response?.meta,
+          query,
+        }
+      }
+
+      // Check if data array is empty
+      if (response.data.length === 0) {
+        return {
+          status: 'empty',
+          articles: [],
+          meta: response.meta,
+          query,
+        }
+      }
+
+      return {
+        status: 'success',
+        articles: response.data,
+        meta: response.meta,
+        query,
+      }
+    } catch (error) {
+      console.error('Strapi fetch error:', error)
+      return {
+        status: 'error',
+        articles: [],
+        error:
+          error instanceof Error
+            ? error.message
+            : 'Failed to connect to Strapi',
+        query,
+      }
+    }
   },
 })
 
+function StrapiServerInstructions() {
+  return (
+    <div className="bg-slate-800/50 rounded-lg p-6 text-left mt-6">
+      <h2 className="text-lg font-semibold text-white mb-4">
+        Start the Strapi Server
+      </h2>
+      <div className="space-y-2 text-sm font-mono text-gray-400">
+        <p>
+          <span className="text-cyan-400">$</span> cd ../server
+        </p>
+        <p>
+          <span className="text-cyan-400">$</span> npm install
+        </p>
+        <p>
+          <span className="text-cyan-400">$</span> npm run develop
+        </p>
+      </div>
+      <p className="text-gray-500 text-sm mt-4">
+        Then create an admin at{' '}
+        <a
+          href="http://localhost:1337/admin"
+          target="_blank"
+          rel="noopener noreferrer"
+          className="text-cyan-400 hover:underline"
+        >
+          http://localhost:1337/admin
+        </a>
+      </p>
+    </div>
+  )
+}
+
+function ConnectionError({ error }: { error?: string }) {
+  return (
+    <div className="bg-amber-900/20 border border-amber-500/50 rounded-xl p-8">
+      <div className="flex items-start gap-4">
+        <div className="text-amber-400 text-2xl">⚠️</div>
+        <div>
+          <h2 className="text-xl font-semibold text-amber-400 mb-2">
+            Cannot Connect to Strapi
+          </h2>
+          <p className="text-gray-300 mb-4">
+            Make sure your Strapi server is running at{' '}
+            <code className="text-cyan-400 bg-slate-800 px-2 py-1 rounded">
+              http://localhost:1337
+            </code>
+          </p>
+          {error && (
+            <p className="text-gray-500 text-sm mb-4">Error: {error}</p>
+          )}
+          <StrapiServerInstructions />
+        </div>
+      </div>
+    </div>
+  )
+}
+
+function NoArticlesFound({ query }: { query?: string }) {
+  if (query) {
+    return (
+      <div className="bg-slate-800/50 border border-slate-700 rounded-xl p-8">
+        <div className="text-center">
+          <div className="text-6xl mb-4">🔍</div>
+          <h2 className="text-2xl font-semibold text-white mb-4">
+            No Results Found
+          </h2>
+          <p className="text-gray-400 mb-6 max-w-md mx-auto">
+            No articles match your search for "{query}". Try adjusting your
+            search terms.
+          </p>
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div className="bg-slate-800/50 border border-slate-700 rounded-xl p-8">
+      <div className="text-center">
+        <div className="text-6xl mb-4">📝</div>
+        <h2 className="text-2xl font-semibold text-white mb-4">
+          No Articles Yet
+        </h2>
+        <p className="text-gray-400 mb-6 max-w-md mx-auto">
+          Your Strapi server is running, but there are no published articles.
+          Create and publish your first article to see it here.
+        </p>
+
+        <div className="bg-slate-900/50 rounded-lg p-6 text-left max-w-md mx-auto">
+          <h3 className="text-lg font-semibold text-white mb-4">
+            How to add articles:
+          </h3>
+          <ol className="space-y-3 text-gray-400">
+            <li className="flex gap-3">
+              <span className="text-cyan-400 font-bold">1.</span>
+              <span>
+                Open{' '}
+                <a
+                  href="http://localhost:1337/admin"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="text-cyan-400 hover:underline"
+                >
+                  Strapi Admin Panel
+                </a>
+              </span>
+            </li>
+            <li className="flex gap-3">
+              <span className="text-cyan-400 font-bold">2.</span>
+              <span>
+                Go to <strong className="text-white">Content Manager</strong> →{' '}
+                <strong className="text-white">Article</strong>
+              </span>
+            </li>
+            <li className="flex gap-3">
+              <span className="text-cyan-400 font-bold">3.</span>
+              <span>
+                Click <strong className="text-white">Create new entry</strong>
+              </span>
+            </li>
+            <li className="flex gap-3">
+              <span className="text-cyan-400 font-bold">4.</span>
+              <span>
+                Fill in the details and click{' '}
+                <strong className="text-white">Publish</strong>
+              </span>
+            </li>
+          </ol>
+        </div>
+      </div>
+    </div>
+  )
+}
+
 function RouteComponent() {
-  const strapiArticles = Route.useLoaderData()
+  const { status, articles, meta, error, query } = Route.useLoaderData()
 
   return (
     <div className="min-h-screen bg-gradient-to-b from-slate-900 via-slate-800 to-slate-900 p-8">
       <div className="max-w-7xl mx-auto">
-        <h1 className="text-4xl font-bold mb-8 text-white">
+        <h1 className="text-4xl font-bold mb-6 text-white">
           <span className="bg-gradient-to-r from-cyan-400 to-blue-400 bg-clip-text text-transparent">
             Strapi
           </span>{' '}
           <span className="text-gray-300">Articles</span>
         </h1>
 
-        {strapiArticles && strapiArticles.length > 0 ? (
-          <div className="grid gap-6 md:grid-cols-2 lg:grid-cols-3">
-            {strapiArticles.map((article) => (
-              <Link
-                key={article.id}
-                to="/demo/strapi/$articleId"
-                params={{ articleId: article.documentId }}
-                className="block"
-              >
-                <article className="bg-slate-800/50 backdrop-blur-sm border border-slate-700 rounded-xl p-6 hover:border-cyan-500/50 transition-all duration-300 hover:shadow-lg hover:shadow-cyan-500/10 cursor-pointer h-full">
-                  <h2 className="text-xl font-semibold text-white mb-3">
-                    {article.title || 'Untitled'}
-                  </h2>
-
-                  {article.description && (
-                    <p className="text-gray-400 mb-4 leading-relaxed">
-                      {article.description}
-                    </p>
-                  )}
-
-                  {article.content && (
-                    <p className="text-gray-400 line-clamp-3 leading-relaxed">
-                      {article.content}
-                    </p>
-                  )}
-
-                  {article.createdAt && (
-                    <p className="text-sm text-cyan-400/70 mt-4">
-                      {new Date(article.createdAt).toLocaleDateString()}
-                    </p>
-                  )}
-                </article>
-              </Link>
-            ))}
-          </div>
-        ) : (
-          <p className="text-gray-400">No articles found.</p>
+        <div className="mb-8">
+          <Search />
+        </div>
+
+        {status === 'error' && <ConnectionError error={error} />}
+
+        {status === 'empty' && <NoArticlesFound query={query} />}
+
+        {status === 'success' && (
+          <>
+            <div className="grid gap-6 md:grid-cols-2 lg:grid-cols-3">
+              {articles.map((article: TArticle) => (
+                <Link
+                  key={article.id}
+                  to="/demo/strapi/$articleId"
+                  params={{ articleId: article.documentId }}
+                  className="block"
+                >
+                  <article className="bg-slate-800/50 backdrop-blur-sm border border-slate-700 rounded-xl overflow-hidden hover:border-cyan-500/50 transition-all duration-300 hover:shadow-lg hover:shadow-cyan-500/10 cursor-pointer h-full flex flex-col">
+                    <StrapiImage
+                      src={article.cover?.url}
+                      alt={article.cover?.alternativeText || article.title}
+                      className="w-full h-48"
+                    />
+
+                    <div className="p-6 flex flex-col flex-1">
+                      <h2 className="text-xl font-semibold text-white mb-3">
+                        {article.title || 'Untitled'}
+                      </h2>
+
+                      {article.description && (
+                        <p className="text-gray-400 mb-4 leading-relaxed line-clamp-2">
+                          {article.description}
+                        </p>
+                      )}
+
+                      <div className="mt-auto flex items-center justify-between">
+                        {article.author?.name && (
+                          <span className="text-sm text-gray-500">
+                            By {article.author.name}
+                          </span>
+                        )}
+                        {article.createdAt && (
+                          <span className="text-sm text-cyan-400/70">
+                            {new Date(article.createdAt).toLocaleDateString()}
+                          </span>
+                        )}
+                      </div>
+
+                      {article.category?.name && (
+                        <div className="mt-3">
+                          <span className="text-xs px-2 py-1 bg-slate-700 text-cyan-400 rounded-full">
+                            {article.category.name}
+                          </span>
+                        </div>
+                      )}
+                    </div>
+                  </article>
+                </Link>
+              ))}
+            </div>
+
+            {meta?.pagination && meta.pagination.pageCount > 1 && (
+              <div className="mt-8">
+                <Pagination pageCount={meta.pagination.pageCount} />
+              </div>
+            )}
+          </>
         )}
       </div>
     </div>

package/dist/frameworks/react/add-ons/strapi/assets/src/types/strapi.ts

@@ -0,0 +1,90 @@
+/**
+ * Strapi type definitions
+ * These types match the Strapi Cloud Template Blog schema
+ */
+
+import type { Block } from "@/components/blocks";
+
+// Base image type from Strapi media library
+export type TImage = {
+  id: number;
+  documentId: string;
+  alternativeText: string | null;
+  url: string;
+};
+
+// Author content type
+export type TAuthor = {
+  id: number;
+  documentId: string;
+  name: string;
+  email?: string;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string;
+};
+
+// Category content type
+export type TCategory = {
+  id: number;
+  documentId: string;
+  name: string;
+  slug: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string;
+};
+
+// Article content type
+export type TArticle = {
+  id: number;
+  documentId: string;
+  title: string;
+  description: string;
+  slug: string;
+  cover?: TImage;
+  author?: TAuthor;
+  category?: TCategory;
+  blocks?: Array<Block>;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string;
+};
+
+// Strapi response wrappers
+export type TStrapiResponseSingle<T> = {
+  data: T;
+  meta?: {
+    pagination?: TStrapiPagination;
+  };
+};
+
+export type TStrapiResponseCollection<T> = {
+  data: Array<T>;
+  meta?: {
+    pagination?: TStrapiPagination;
+  };
+};
+
+export type TStrapiPagination = {
+  page: number;
+  pageSize: number;
+  pageCount: number;
+  total: number;
+};
+
+export type TStrapiError = {
+  status: number;
+  name: string;
+  message: string;
+  details?: Record<string, Array<string>>;
+};
+
+export type TStrapiResponse<T = null> = {
+  data?: T;
+  error?: TStrapiError;
+  meta?: {
+    pagination?: TStrapiPagination;
+  };
+};

package/dist/frameworks/react/add-ons/strapi/info.json

@@ -11,9 +11,9 @@
   "routes": [
     {
       "url": "/demo/strapi",
-      "name": "Strapi",
-      "path": "src/routes/demo.strapi.tsx",
-      "jsName": "StrapiDemo"
+      "name": "Strapi Articles",
+      "path": "src/routes/demo/strapi.tsx",
+      "jsName": "StrapiArticles"
     }
   ]
 }

package/dist/frameworks/react/add-ons/strapi/package.json

@@ -1,5 +1,8 @@
 {
   "dependencies": {
-    "@strapi/client": "^1.5.0"
+    "@strapi/client": "^1.6.0",
+    "react-markdown": "^9.0.1",
+    "remark-gfm": "^4.0.0",
+    "use-debounce": "^10.0.0"
   }
-}
+}

package/dist/frameworks.js

@@ -67,6 +67,7 @@ export function scanAddOnDirectories(addOnsDirectories) {
             addOns.push({
                 ...info,
                 id: dir,
+                version: info.version ?? '0.0.0',
                 packageAdditions,
                 packageTemplate,
                 readme,

package/dist/index.js

@@ -17,7 +17,7 @@ export { writeConfigFileToEnvironment, readConfigFileFromEnvironment, readConfig
 export { cleanUpFiles, cleanUpFileArray, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
 export { formatCommand, handleSpecialURL } from './utils.js';
 export { initStarter, compileStarter } from './custom-add-ons/starter.js';
-export { initAddOn, compileAddOn } from './custom-add-ons/add-on.js';
+export { initAddOn, compileAddOn, devAddOn } from './custom-add-ons/add-on.js';
 export { createAppOptionsFromPersisted, createSerializedOptionsFromPersisted, } from './custom-add-ons/shared.js';
 export { createSerializedOptions } from './options.js';
 export { getRawRegistry, getRegistry, getRegistryAddOns, getRegistryStarters, } from './registry.js';

package/dist/types/custom-add-ons/add-on.d.ts

@@ -61,6 +61,14 @@ export declare function generateProject(persistedOptions: PersistedOptions): Pro
         addOnSpecialSteps?: string[] | undefined;
         createSpecialSteps?: string[] | undefined;
         postInitSpecialSteps?: string[] | undefined;
+        envVars?: {
+            name: string;
+            file?: ".env" | ".env.local" | undefined;
+            description?: string | undefined;
+            default?: string | undefined;
+            required?: boolean | undefined;
+            secret?: boolean | undefined;
+        }[] | undefined;
         integrations?: {
             type?: string | undefined;
             code?: string | undefined;
@@ -79,4 +87,5 @@ export declare function buildAssetsDirectory(output: {
 export declare function updateAddOnInfo(environment: Environment): Promise<void>;
 export declare function compileAddOn(environment: Environment): Promise<void>;
 export declare function initAddOn(environment: Environment): Promise<void>;
+export declare function devAddOn(environment: Environment): Promise<void>;
 export declare function loadRemoteAddOn(url: string): Promise<AddOn>;

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ export { writeConfigFileToEnvironment, readConfigFileFromEnvironment, readConfig
 export { cleanUpFiles, cleanUpFileArray, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
 export { formatCommand, handleSpecialURL } from './utils.js';
 export { initStarter, compileStarter } from './custom-add-ons/starter.js';
-export { initAddOn, compileAddOn } from './custom-add-ons/add-on.js';
+export { initAddOn, compileAddOn, devAddOn } from './custom-add-ons/add-on.js';
 export { createAppOptionsFromPersisted, createSerializedOptionsFromPersisted, } from './custom-add-ons/shared.js';
 export { createSerializedOptions } from './options.js';
 export { getRawRegistry, getRegistry, getRegistryAddOns, getRegistryStarters, } from './registry.js';