Skip to content

heysambit/bookbrain

Repository files navigation

BookBrain: Books as Software

Transform books into actionable solutions. BookBrain is a curated library of book insights with copyable meta-prompts to help you apply wisdom to real-world challenges.

Features

  • Curated Book Library: Hand-picked books with comprehensive summaries
  • 🎯 Action-Oriented Meta-Prompts: Copyable prompts to apply book concepts to your situations
  • 🏷️ Multiple Categories: Business, Psychology, Productivity, Biography, Philosophy, Finance, Relationship, Mindfulness, Creativity, Technology
  • Smart Search & Filtering: Find books by title, author, topic, or category
  • 🌙 Dark/Light Mode: Beautiful design in both themes
  • Responsive Design: Works perfectly on all devices

Book Entry Structure

Each book includes:

  • Title & Author: Basic book information
  • Summary: 2-3 sentence hook explaining the book's value
  • Primary Learnings: 5-7 key takeaways
  • Meta-Prompts: 3 actionable prompts with real scenarios
  • Extended Data: Quotes, related books, target audience, ratings
  • Deep Dive: Detailed explanations of core concepts

Getting Started

Local Development

# Clone the repository
git clone <your-repo-url> bookbrain
cd bookbrain

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:4321 to see your site.

Adding New Books

  1. Create a new markdown file in src/data/directory/ (e.g., your-book-title.md)
  2. Use this template:
---
title: "Book Title"
author: "Author Name"
genre: ["Category1", "Category2"]
topics: ["Topic1", "Topic2", "Topic3"]
summary: "2-3 sentence summary of the book's value proposition"
primaryLearnings:
  - "Key learning 1"
  - "Key learning 2"
  - "Key learning 3"
metaPrompts:
  - title: "Prompt Title"
    scenario: "When you face this situation..."
    promptContent: |
      Your actionable prompt template here.
      Use [PLACEHOLDERS] for user customization.
extendedData:
  whoIsThisFor: "Target audience description"
  rating: 5
  quotes:
    - "Memorable quote from the book"
  relatedBooks: ["book-slug-1", "book-slug-2"]
---

## Main Content

Your detailed book breakdown here...
  1. The dev server will automatically pick up the new book

Customization

  • Categories: Edit src/config/settings.toml to modify categories
  • Styling: Modify Tailwind classes in components
  • Layout: Adjust src/components/directory/cards/RectangleCard.astro for card design

Tech Stack

  • Astro: Fast, content-focused framework
  • Tailwind CSS: Utility-first styling
  • TypeScript: Type-safe development
  • Zod: Schema validation

Project Structure

src/
├── components/
│   ├── directory/      # Book grid and cards
│   ├── ui/             # Reusable UI components
│   └── app/            # App shell components
├── data/
│   ├── directory/      # Book markdown files
│   └── pages/          # Page content (index, about, etc.)
├── layouts/            # Page layouts
├── pages/              # Route definitions
├── validation/         # Zod schemas
└── config/            # Site configuration

License

MIT

Credits

Built with Minted Directory Astro starter template.

About

Discover actionable insights from the world’s best books. Each entry includes copyable meta-prompts to help you apply book wisdom to your specific challenges.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors