ghostcompiler avatar
Sign In

Developer Hub

Blade

A premium Developer Portfolio, Repository Catalog, and Markdown Documentation Explorer built with Laravel. Features automated GitHub sync, a developer blog platform, and secure user access with 2FA.

GitHub Download ZIP
Stars
2
Forks
0
Downloads
8
Open Issues
0

About

Developer Hub is an open-source platform for developer visibility. It syncs GitHub repositories into rich, crawlable documentation pages and gives registered users a dashboard to submit blogs, link external repos, and share suggestions — all moderated through an admin approval workflow.

Whether you are publishing SDK docs, listing community projects, or growing organic traffic to your GitHub profile, Developer Hub handles the SEO layer so your repositories and writing get found.

Features

  • GitHub repo sync — Automatically pulls repositories, READMEs, file trees, and metadata from a GitHub profile via github:sync
  • SEO-first project pages — Structured project pages with code explorer, schema markup, sitemap.xml, and llms.txt for search engines and AI crawlers
  • Community blogs — Users can register, write Markdown posts, and publish after admin approval
  • Linked repositories — Submit and showcase external GitHub repos alongside official projects
  • User dashboard — Manage profile, blogs, linked repos, and API tokens
  • Admin command center — Approve submissions, manage users, and configure site settings
  • Authentication — Email verification, password reset, social login (OAuth), and two-factor authentication
  • REST API — Sanctum-powered API for linked repo integrations

Requirements

  • PHP 8.3+
  • Composer 2
  • Node.js 18+ and npm
  • SQLite (default) or MySQL / PostgreSQL

Installation

# Clone the repository
git clone https://github.com/ghostcompiler/ghostcompiler.git
cd ghostcompiler

# Install dependencies and set up the app
composer setup

Or step by step:

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run build

Environment

Copy .env.example to .env and configure at minimum:

| Variable | Description | |---|---| | APP_NAME | Application name (e.g. Developer Hub) | | APP_URL | Public URL of your deployment | | DB_CONNECTION | Database driver (sqlite by default) | | GITHUB_TOKEN | GitHub personal access token for repo sync |

Sync GitHub repositories

php artisan github:sync

Development server

composer dev

This starts the Laravel server, queue worker, log tail, and Vite dev server concurrently.

Project structure

| Path | Purpose | |---|---| | app/Http/Controllers/ | Web and API controllers | | app/Console/Commands/ | github:sync, project tree caching | | app/Models/ | Projects, blogs, linked repos, users | | resources/views/ | Blade templates for public and dashboard UI | | routes/web.php | Public routes, auth, dashboard, SEO endpoints | | routes/api.php | Sanctum API routes |

SEO endpoints

| URL | Description | |---|---| | /sitemap.xml | Dynamic sitemap for projects, blogs, and repo files | | /llms.txt | Machine-readable site summary for AI crawlers | | /robots.txt | Crawler directives with sitemap reference |

Testing

composer test

License

This project is open-sourced under the MIT license.