Skip to content

focusbp/fbp-codex-booster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

148 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FBP Codex Booster

Generated customer management demo

Get Codex building structured PHP business apps in minutes.

FBP Codex Booster is a ready-to-run PHP app base for Codex. Instead of asking Codex to design everything from scratch, FBP gives it a working structure from the first prompt.

It gives Codex a predictable place to create screens, data flows, business actions, public pages, cron jobs, webhooks, and verification commands.

It is not another Laravel competitor. Think of it as a booster kit for AI coding: clone it, run it, start Codex inside it, and ask Codex to build business app features in a controlled shape.

Try It Now

Requirements:

  • PHP 8+
  • Git

Run:

git clone https://github.com/focusbp/fbp-codex-booster.git
cd fbp-codex-booster
php -S 127.0.0.1:8000 router.php

Open:

http://127.0.0.1:8000/

You should see the FBP login screen.

If port 8000 is already in use:

php -S 127.0.0.1:8001 router.php

Windows / WSL2

On Windows, use WSL2 for the best Codex CLI experience.

sudo apt update
sudo apt install php-cli git nodejs npm
npm install -g @openai/codex

git clone https://github.com/focusbp/fbp-codex-booster.git
cd fbp-codex-booster
php -S 127.0.0.1:8000 router.php

Start Codex

Open another terminal and start Codex from the repository root:

cd fbp-codex-booster
codex

Make Samples

Use these prompts to have Codex generate working sample apps from the bundled skills and assets. Start with the customer sample, then add more samples as needed.

Customer Management

Copy the whole block below and paste it into Codex:

Read README.md and fbp/docs/.agents/skills/fbp-customer-demo/SKILL.md.
Create the default customer management demo.
Use the bundled installer and assets from the skill.
Verify the CRUD screen, seed data, CSV export, and PDF output with the FBP CLI.

Event Registration

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/references/event-registration.md, and fbp/docs/.agents/skills/fbp-app-samples/references/event-registration-db.md.
Create the Event Registration sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_event_registration.php.
Install the event_sessions and event_registrations DBs, registration status options, event session management screen, participants side panel with add/delete/status actions, public registration page, and admin public URL dialog.
Do not add project linkage, public registration history, public cancellation, external calendar sync, email sending, or credentials.
Verify the admin screen, public registration URL dialog, public registration page, DB schema, seed data, and PHP syntax with the FBP CLI.

Schedule Appointment

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/references/schedule-appointment.md, and fbp/docs/.agents/skills/fbp-app-samples/references/schedule-appointment-db.md.
Create the Schedule Appointment sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_schedule_appointment.php.
Install the schedule_appointment_slots DB, booked/blocked/cancelled appointment status options, logged-in-user scoped weekly admin schedule screen, per-user public URL dialog, and public appointment calendar.
Public Select buttons should appear only on empty future 30-minute cells; existing non-cancelled schedule rows should appear as Busy.
Do not add external calendar sync, email sending, payment, public cancellation, customer login, or credentials.
Verify the admin calendar, public URL dialog, public calendar, empty-cell booking flow, DB schema, seed data, and PHP syntax with the FBP CLI.

LINE Bot Basic

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, and fbp/docs/.agents/skills/fbp-webhook/SKILL.md.
Create the LINE Bot basic sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_line_bot_basic.php.
Install the line_member DB, member_type options, line_webhook receiver, basic webhook_rule action classes, public profile page, and LINE member management screen.
Do not add LINE secrets or tokens to code.
Verify the LINE member management screen, webhook_rule list, DB schema, and PHP syntax with the FBP CLI.

Web Commerce Basic

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/references/web-commerce-basic.md, fbp/docs/.agents/skills/fbp-app-samples/references/web-commerce-basic-db.md, and fbp/docs/.agents/skills/fbp-square-payment/SKILL.md.
Create the Web Commerce Basic sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_web_commerce_basic.php.
Install the shop_member, shop_product_category, shop_product, shop_product_variant, shop_customer_order, and shop_customer_order_item DBs; email/password public member registration; public product list/detail; cart; checkout; real Square payment flow; paid order creation; simple stock_quantity decrement; member order history; Shop Orders public EC link dialog; and seed products.
Keep all sample-owned DB tables prefixed with shop_.
Do not add LINE entry, email verification, multi-store behavior, shop-scoped Square OAuth, lot inventory, shipment automation, email sending, receipt PDF, credentials, domains, or production data.
Verify the public shop page, member login/register pages, DB schema, seed data, installer output, manifest JSON, and PHP syntax with the FBP CLI. Live Square payment requires Square credentials in app settings.

Service User Management

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-service-user-management/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/references/service-user-management.md, fbp/docs/.agents/skills/fbp-app-samples/references/service-user-management-db.md, and fbp/docs/.agents/skills/fbp-square-payment/SKILL.md.
Create the Service User Management sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_service_user_management.php.
Install the service_member, service_plan, service_subscription, service_payment, and service_password_reset DBs; public service registration; login/logout; password reset token flow; plan selection; Square card payment; subscription activation; payment history; and Service Members public link dialog.
Keep all sample-owned DB tables prefixed with service_.
Do not add ecommerce cart, product catalog, shipping, inventory, order items, LINE entry, team accounts, SSO, tenant isolation, recurring billing automation, Square OAuth, email delivery, credentials, domains, or production data.
Verify the public plans/register/login/password reset/account pages, DB schema, seed data, installer output, manifest JSON, and PHP syntax with the FBP CLI. Live Square payment requires Square credentials in app settings.

MCP Service App

Copy the whole block below and paste it into Codex:

Read README.md, fbp/docs/.agents/skills/fbp-mcp-server/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/SKILL.md, fbp/docs/.agents/skills/fbp-app-samples/references/mcp-service-app.md, and fbp/docs/.agents/skills/fbp-app-samples/references/mcp-service-app-db.md.
Create the MCP Service App sample.
Run the bundled installer: php fbp/docs/.agents/skills/fbp-app-samples/scripts/install_mcp_service_app.php.
Install the service_member and service_item DBs; public account creation; minimal portal that only shows the MCP endpoint URL; MCP-specific login separated from public login; custom MCP subject provider; service_items App Action tool; and owner-scoped list/create/update/delete item operations.
Keep all sample-owned DB tables prefixed with service_.
Do not add dashboards, aggregate counters, payment, ecommerce, Square, email delivery, password reset, public item management UI, team accounts, SSO, external API integration, credentials, domains, or production data.
Verify the public register/portal pages, MCP login page, DB schema, seed data, installer output, manifest JSON, and PHP syntax with the FBP CLI.

Generated Customer Demo

After the customer prompt above, Codex creates a customer management demo with CRUD, CSV import/export, and PDF output.

Generated customer PDF output

Generated Event Registration Sample

After the Event Registration prompt above, Codex creates a no-external-service event registration demo with event_sessions, event_registrations, an admin event session management screen, a participants side panel with add/delete/status actions, a public registration page, and a dialog that shows the public registration URL.

The public registration path is:

/event_registration_public*page

Generated Schedule Appointment Sample

After the Schedule Appointment prompt above, Codex creates a one-note appointment booking demo with schedule_appointment_slots, a weekly admin schedule calendar scoped to the logged-in user, a public URL dialog with encrypted user.id, and a public booking calendar where empty future cells can be selected and existing non-cancelled schedules are shown as busy.

The public appointment path is:

/schedule_appointment_public*calendar&user=<encrypted-user-id>

Generated LINE Bot Basic Sample

After the LINE Bot Basic prompt above, Codex creates a minimal LINE Bot base with line_member, line_webhook, webhook_rule records, a public profile page, and a LINE member management screen.

Configure LINE credentials in app settings, then set the LINE Messaging API webhook path to:

/line_webhook*receive

Generated Web Commerce Basic Sample

After the Web Commerce Basic prompt above, Codex creates a normal web storefront with shop_member, shop_product_category, shop_product, shop_product_variant, shop_customer_order, and shop_customer_order_item, plus public member registration, cart, checkout, Square payment, paid order creation, order history, and a Shop Orders admin button that shows the public storefront link.

The public shop path is:

/public_pages*shop

Deploy To Apache

Upload these folders to the same parent directory on your Apache server:

/path/to/site/
  fbp/
  classes/
  • fbp/ contains the framework runtime, app.php, assets, and .htaccess.
  • classes/ contains generated app code, app data, and logs.
  • .git/, nbproject/, and local editor files are not needed on the server.
  • docs/, README.md, and router.php are not required for Apache runtime.

Recommended Apache setup:

DocumentRoot /path/to/site

Then open:

https://example.com/fbp/app.php

If the app is installed under a subdirectory, keep fbp/ and classes/ under the same parent directory:

https://example.com/subdir/fbp/app.php

Make sure the PHP process can write to classes/data and classes/log. The bundled fbp/.htaccess sets app.php as the directory index and blocks web access to cli.php.

What Codex Can Build Here

  • CRUD screens for internal tools
  • Customer, order, task, and workflow management
  • Dashboards and admin panels
  • Public pages and forms
  • Webhooks and cron automation
  • Email, PDF, API, LINE, and Square-connected workflows

Why This Exists

Codex can generate code, but business applications require repeatable patterns.

FBP Codex Booster provides those patterns: routes, screens, actions, data handling, verification commands, and skills.

The goal is not to replace developers. The goal is to give Codex a stable environment where it can build useful business features without starting from zero every time.

License

MIT License.

About

A ready-to-run PHP app base for OpenAI Codex CLI to build business applications.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors