async-labs/builderbook
Builderbook
Builderbook is a MERN stack digital bookstore and documentation platform designed for selling and delivering digital books. It functions as a content delivery site that transforms markdown files hosted in Git repositories into structured online books.
The platform distinguishes itself by synchronizing markdown content from remote repositories into a database to enable metadata-driven access control and content gating. It integrates payment processing to restrict full content access based on verified purchase history, while providing public previews.
The system covers a broad range of capabilities, including identity management via OAuth and passwordless email flows, automated table of contents generation, and search engine optimization. It also includes tools for user role management, transactional email delivery, and cloud storage for file uploads.
The application is built using React, Next.js, Node.js, and MongoDB.
Features
- Digital Book Hosting - Functions as a platform for hosting and delivering digital books and technical documentation to end users.
- Digital Book Sales - Operates as a platform for selling digital books and documentation gated behind payment processing.
- Stripe Billing Integrations - Integrates Stripe to link user identities with purchase records for controlling access to digital books.
- Payment Integrations - Integrates third-party payment gateways to handle checkout sessions and record financial transactions.
- Book Metadata Management - Uses database schemas to manage book metadata such as titles and pricing.
- Chapter Delivery Systems - Provides a dedicated page and API system to retrieve and display specific content chapters to authorized users.
- Git-Driven Documentation Platforms - Publishes structured websites by syncing markdown files from a Git repository and rendering them as web pages.
- Git-Synced Publishing Pipelines - Syncs markdown files from Git repositories to create structured sites with metadata-driven access control.
- MongoDB Schema Modeling - Uses Mongoose schemas to define rigid data structures for users, books, and purchases in MongoDB.
- User Data Management - Implements a data model for creating, retrieving, and managing user information within a persistent database.
- Remote Repository Synchronization - Implements a system to synchronize markdown content from remote Git repositories into a database for online delivery.
- Purchase-Based Restrictions - Restricts full content access based on verified purchase history while allowing public previews.
- OAuth and Identity Providers - Delegates user authentication to external identity providers using OAuth and session cookies.
- User Role Management - Provides tools for assigning and managing user roles such as Public, Customer, and Admin.
- User Account Management - Manages user registration, identity profiles, and account settings using a persistent database.
- OAuth Authentication - Implements OAuth 2.0 authentication flows to verify user identities via third-party providers.
- GitHub OAuth Integrations - Integrates GitHub OAuth to allow users to sign in and grant access to their repositories.
- Google OAuth Providers - Integrates Google OAuth for user authentication, including session callbacks and logout management.
- Role-Based Access Control - Manages user permissions to restrict API endpoints and page visibility based on roles like Customer or Admin.
- Cookie-Based Session Management - Manages user sessions using database-backed storage and browser cookies for identity tracking.
- OAuth Integrations - Integrates Google and GitHub OAuth providers to manage user authentication and secure account access.
- Payment-Gated Access - Restricts access to full book content based on verified purchase history while providing public previews.
- Markdown Database Syncs - Synchronizes markdown files from version control into a database to enable structured content delivery.
- Authentication Route Guards - Intercepts navigation requests to verify user sessions before granting access to protected pages.
- MERN Stack Applications - Implemented as a digital bookstore application using the MongoDB, Express, React, and Node.js stack.
- Documentation Frameworks - Provides a content delivery site that transforms Git-hosted markdown files into a structured online book.
- Node.js Web Applications - Built as a full-stack web application using React, Next.js, Node.js, and MongoDB.
- Search Engine Optimization - Generates robots.txt and sitemap.xml files and integrates analytics to improve search visibility.
- Automatic Table of Contents - Automatically generates navigable sidebars with hyperlinked headings based on the markdown content of books.
- Social Login Integrations - Integrates multiple third-party social login providers to simplify the user sign-in process.
- Passwordless Email Flows - Provides a passwordless authentication flow using secure email magic links to establish user sessions.
- Global State Managers - Implements a centralized store to manage global client-side data and shared state across the application.
- Server-Side Rendering - Uses server-side rendering to generate HTML, improving initial load times and search engine visibility.
