GitBase  by qiayue

AI-powered website framework using GitHub as a CMS

Created 1 year ago
829 stars

Top 42.9% on SourcePulse

GitHubView on GitHub
Project Summary

GitBase offers a database-free dynamic website framework that utilizes GitHub as its content management system. Designed for developers and power users, it simplifies website creation and management by integrating Next.js, Tailwind CSS, and an AI-powered development center, enabling autonomous feature evolution and content updates directly from GitHub.

How It Works

GitBase employs a novel architecture where GitHub serves as the primary content repository and CMS, eliminating the need for traditional databases. Content is written in Markdown and rendered dynamically using Next.js server-side rendering. A key differentiator is its AI-Powered Feature Development Center, which leverages Claude AI via OpenRouter to generate code from natural language prompts, analyzing project structure via the GitHub API and committing changes efficiently using GitHub's Git Trees API for batch operations.

Quick Start & Requirements

  • Prerequisites: Node.js (>= 14), npm, Git, GitHub account, Vercel account.
  • Installation: Clone the repository (git clone https://github.com/qiayue/gitbase.git), navigate into it (cd gitbase), and install dependencies (npm install).
  • Configuration: Create a .env.local file with GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO, JWT_SECRET, DOMAIN, ACCESS_USERNAME, and ACCESS_PASSWORD. Set up a GitHub repository with data/json/resources.json (empty array) and a data/md folder.
  • Development: Run npm run dev to start the local server at http://localhost:3000.
  • Deployment: Push code to GitHub and deploy via Vercel, configuring environment variables.
  • Links: Installation and Deployment Guide (mentioned in README).

Highlighted Details

  • Database-free Architecture: Content and management are entirely GitHub-based.
  • AI-Powered Feature Development: Enables autonomous website evolution by generating code from natural language requests.
  • Self-Evolving CMS: Websites can add new features and capabilities through AI-driven development.
  • Batch Commit Optimization: Utilizes GitHub's Git Trees API for efficient, atomic commits, minimizing API rate limit issues.
  • Admin Interface: Provides a built-in panel for content management and AI feature configuration.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord or Slack. Support is available by filing issues on the GitHub repository.

Licensing & Compatibility

GitBase is licensed under the permissive MIT license, allowing for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

AI-generated code may necessitate manual adjustments or iterative refinement. The AI lacks direct access to databases or environment variables, and file deletion is intentionally disabled for safety. Admin sessions expire after one hour.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
0
Star History
13 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.