Carlos Arias
e13c0b9e19
The Node content pipeline (agents/) and the astroagent in-site authoring console are a proprietary, CLI-strategy agent system that shouldn't ship in the cloneable SeedProject base. Remove both and all their wiring: - Delete agents/ (pipeline scripts, prompts, admin server, libs) + runtime - Delete astroagent config, app/.astroagent/ skill, DevConsole component; unhook it from BaseLayout.astro and astro.config.mjs preview env logic - Delete api/cli/resources.php (DB->pipeline resource bridge) - Drop agent blocks from configure.mjs, agent runtime rules from .gitignore, topic/audience from site.config.json, agent prompts from new-site.sh - Strip agent sections from AGENTS.md / README.md / api/.memory/foundation.md Kept: api/app/LLM/* (API-key/REST multi-provider layer — distinct from the CLI agents), api/cli/rebuild.php, and the mde_resources schema. Frontend build verified (npm run build → 14 pages). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DfzaSFv5okUxCCdvq5RXu1
97 lines
3.9 KiB
Markdown
97 lines
3.9 KiB
Markdown
# SeedProject base
|
|
|
|
A cloneable foundation for building websites — a static [Astro](https://astro.build)
|
|
frontend with a PHP backend. Clone it, set one config file, and build out a new
|
|
site (a lawyer's office, a roofing company, a niche publication) the way you'd spin
|
|
up a new WordPress install — but faster to host and safer to run.
|
|
|
|
## What's inside
|
|
|
|
| Path | Role | "WordPress equivalent" |
|
|
|------|------|------------------------|
|
|
| `app/` | Astro theme — layouts, components, content collections, sample post | theme + posts |
|
|
| `api/` | [SeedProject](api/.memory/documentation.md) PHP framework — the dynamic backend (DB, forms, metrics) | PHP core |
|
|
| `site.config.json` | **Single source of site identity** — the one file you edit per site | wp-config + Site Settings |
|
|
|
|
## Quick start — spin up a new site
|
|
|
|
```bash
|
|
git clone https://repo.carlosarias.com/carlos/seedproject-web.git my-site
|
|
cd my-site
|
|
./scripts/new-site.sh # prompts for name/URL/author → writes site.config.json,
|
|
# stamps every engine, (optionally) resets git + installs deps
|
|
cd app && npm run build # builds the static site into ./public
|
|
```
|
|
|
|
Then point a web server's document root at `./public` and alias `/api` to `./api`
|
|
(see [Backend](#backend-api)).
|
|
|
|
## The one file you edit: `site.config.json`
|
|
|
|
All site identity lives here:
|
|
|
|
```json
|
|
{
|
|
"name": "Acme Roofing",
|
|
"url": "https://acmeroofing.com",
|
|
"description": "Denver's trusted roofing contractor since 1998.",
|
|
"tagline": "Roofs done right",
|
|
"language": "en",
|
|
"timezone": "America/Denver",
|
|
"topic": "residential and commercial roofing",
|
|
"audience": "Denver-area homeowners and property managers",
|
|
"author": { "slug": "acme", "name": "Acme Roofing", "jobTitle": "...", "avatar": "/avatar-placeholder.png", "bio": "...", "longBio": "...", "knowsAbout": [], "sameAs": [] },
|
|
"social": { "twitter": "" }
|
|
}
|
|
```
|
|
|
|
After editing it, run:
|
|
|
|
```bash
|
|
node scripts/configure.mjs
|
|
```
|
|
|
|
This stamps the values into the Astro theme (`app/src/config/site.json`).
|
|
`new-site.sh` runs it for you.
|
|
|
|
## Backend (`api/`)
|
|
|
|
The `api/` directory is the SeedProject PHP framework, meant to be served at
|
|
`/api` on the same domain (the static frontend calls it same-origin). It needs:
|
|
|
|
- **Composer deps:** `cd api && composer install`
|
|
- **Config:** `api/config.php` with your database credentials (git-ignored). Until
|
|
the CLI installer ships (see below), create it by hand or use the framework's
|
|
web installer under `api/install/`.
|
|
- **A PHP-FPM handler** in your web server for `/api`, with a front-controller
|
|
rewrite to `api/index.php`. Example Apache/nginx snippets are in
|
|
[`api/.memory/foundation.md`](api/.memory/foundation.md).
|
|
|
|
> **Planned — the Foundation:** a `php console app:install` (DB + config + schema)
|
|
> and `php console db:migrate`, plus a two-tier auth layer and a `/api/health`
|
|
> round-trip. Design + implementation plan: [`api/.memory/foundation.md`](api/.memory/foundation.md)
|
|
> and [`api/.memory/foundation-plan.md`](api/.memory/foundation-plan.md).
|
|
|
|
## Authoring content
|
|
|
|
Add a post by creating `app/src/content/blog/<slug>/index.mdx` following the
|
|
schema in `app/src/content.config.js` (copy the sample `welcome` post as a template).
|
|
|
|
## Directory layout
|
|
|
|
```
|
|
my-site/
|
|
├── site.config.json ← edit this
|
|
├── scripts/
|
|
│ ├── new-site.sh ← one-time setup for a fresh clone
|
|
│ └── configure.mjs ← stamp site.config.json into every engine
|
|
├── app/ ← Astro frontend (build → ../public)
|
|
├── api/ ← SeedProject PHP backend (served at /api)
|
|
└── public/ ← build output (git-ignored)
|
|
```
|
|
|
|
## What's git-ignored
|
|
|
|
Secrets (`**/.env`, `api/config.php`), dependencies (`node_modules/`, `api/vendor/`),
|
|
build output (`public/`, `app/dist/`), and per-site runtime state. A fresh clone
|
|
installs deps and generates the rest.
|