--- name: bijection-basic-blog description: "Evaluate and integrate the Basic Blog component with Bijection." --- # Basic Blog Headless content management - Package: @bijectionhq/basic-blog - Category: Content Management - Status: Preview - License: Apache-2.0 - Bijection source (repository access required): https://github.com/bijectionhq/basic-blog/tree/f1c8692393b2cb4aa6f4917b7dcc8ddb473570cc/packages/convex-blog-cms - Upstream: https://github.com/daocodotorg/basic-blog/tree/651bcc128a3a67679890961e25a96de12fe49e2d/packages/convex-blog-cms - Documentation: https://docs.bijection.com/components/using - Directory: https://bijection.com/components/basic-blog ## Get the source Bijection repository access is required. Request access at https://bijection.com/contact. ```sh git clone https://github.com/bijectionhq/basic-blog.git cd basic-blog git checkout f1c8692393b2cb4aa6f4917b7dcc8ddb473570cc cd packages/convex-blog-cms ``` ## Before using this component Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute. ## Integration workflow 1. Read the source README and package manifest at the recorded revision. 2. Confirm the required SDK, dependency availability, and runtime compatibility. 3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name. 4. Keep credentials in the project's existing secret store. 5. Follow the project's execution rules for verification and report what was actually checked. ## Original upstream skill The following guidance describes basic-blog-convex-blog-cms. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately. # Basic Blog ## Instructions Use Basic Blog to headless blog cms as a convex component with bundled tiptap admin ui, next.js helpers, rss/sitemap generation, and file uploads. This Convex component integrates directly with your backend. ### Installation ```bash npm install basic-blog-convex-blog-cms ``` ### Capabilities - Deploy a complete blog CMS with one npm install and minimal configuration - Get a production-ready admin interface with TipTap editor and file uploads - Generate SEO-optimized RSS feeds, sitemaps, and JSON-LD automatically - Build custom frontends while keeping content management centralized ## Examples ### how to add blog CMS to Convex app Install basic-blog-convex-blog-cms and register it as a Convex component. The package provides posts, blocks, and site settings schemas along with queries and mutations. You get a complete headless CMS with admin UI accessible via npx blog-admin-serve. ### Convex blog with admin interface Basic Blog includes a bundled TipTap admin UI that runs locally or deploys to Railway. After installing the component and setting up makeBlogAdminAPI, run npx blog-admin-serve to access the admin at localhost:3847/admin with full content editing capabilities. ### Next.js blog with Convex backend The component includes Next.js helpers for RSS feeds, sitemaps, and JSON-LD generation. You can build custom frontend components using the provided DTOs and public queries while the Convex component handles all backend operations and content management. ## When NOT to use - When a simpler built-in solution exists for your specific use case - If you are not using Convex as your backend - When the functionality provided by Basic Blog is not needed ## Troubleshooting **What does the Basic Blog component include out of the box?** Basic Blog provides Convex schemas for posts, blocks, and site settings, along with queries and mutations for content management. It includes a bundled TipTap admin UI, file upload handling, and helpers for RSS feeds, sitemaps, and JSON-LD generation in Next.js applications. **How do I run the admin interface for Basic Blog?** After installing and configuring the component with makeBlogAdminAPI, run 'CONVEX_URL=https://your-deployment.convex.cloud npx blog-admin-serve' and open http://127.0.0.1:3847/admin. The admin uses the blog.generateUploadUrl endpoint for file uploads and stores images in Convex storage. **Does Basic Blog include frontend components?** No, Basic Blog is a headless CMS component that provides backend functionality and admin UI only. You build your own frontend using the provided DTOs and public queries, or copy reference implementations from the examples/blog-ui and examples/next-app directories in the repository. **Can I deploy the Basic Blog admin interface separately?** Yes, the admin UI can be deployed independently using the included Dockerfile.admin or Railway templates. The admin connects to your Convex deployment via CONVEX_URL environment variable and optionally uses BLOG_ADMIN_API_KEY for authentication. ## Resources - [npm package](https://www.npmjs.com/package/basic-blog-convex-blog-cms) - [GitHub repository](https://github.com/daocodotorg/basic-blog) - [Live demo](https://youtu.be/1HVfBt0kZr4) - [Convex Components Directory](https://www.convex.dev/components/basic-blog-convex-blog-cms) - [Convex documentation](https://docs.convex.dev)