Project history

What changed, who changed it, and why it matters.

A maintained feed for Foundationbase releases, catalog additions, design passes, deployment work, and agent handoffs. Future Codex and Claude sessions are expected to update this when they ship user-visible changes.

Total entries20
Live updates17
Catalog changes5
Agents tracked2

Browse discovery redesign deployed

Deployed a search-first Browse page that feels more like a curated app marketplace and keeps advanced filters behind a drawer.

  • Moved discovery ahead of filtering with a dominant search field, popular search chips, and a featured apps rail.
  • Redesigned catalog cards with larger previews, clearer value hierarchy, trust/setup signals, and Download as the primary action.
  • Moved categories, difficulty, tech stack, Agent Ready, Production Ready, and MIT controls into a right-side drawer on desktop and bottom sheet on mobile.
  • Added synonym-aware search and helpful empty-state recommendations for common queries like money, journal, calendar, invoices, and CRM.

Foundation Workspace SEO pass prepared

Strengthened the Foundation Workspace listing for searches around open source Notion alternatives, self-hosted workspaces, Notion-style templates, and AI-customizable app foundations.

  • Added custom title, meta description, keyword metadata, and license-aware Open Graph/Twitter copy for the Foundation Workspace detail page.
  • Added SoftwareApplication enhancements plus visible FAQ content backed by FAQPage JSON-LD.
  • Updated the downloadable template metadata with an SEO description and keyword list while keeping the scope honest about the current local-first version.

Foundation Workspace template prepared

Prepared an open source Notion-style workspace foundation with nested pages, a block-style editor, lightweight databases, publishing, embeds, export/import, and an agent-readable source package.

  • Added a working local-first Foundation Workspace demo with sidebar page tree, editor canvas, database table/list view, public-page preview, embed preview, and settings.
  • Added Apache-2.0 template docs: README, CUSTOMIZE, DEPLOY, SECURITY, AGENTS, .env example, Docker Compose shape, and Foundation Base metadata.
  • Wired the package generator so `/downloads/foundation-workspace.zip` is generated from source during the build.

Homepage V1 UX overhaul prepared

Prepared a clearer product-led homepage that explains Foundation Base as complete open-source apps people can use, install, customize with AI, deploy, and own.

  • Rebuilt the hero around the existing headline, clearer product copy, action-based CTAs, centered search, suggested searches, and a Builder shortcut sheet.
  • Added the five-step Foundation Base journey directly under the hero: pick, download and install, give it to AI, customize, and deploy.
  • Added homepage-only flagship foundation cards, build examples, larger category cards, a recently updated rail, and a blank-prompt comparison without changing the catalog pages.

Full catalog template scaffold deployed

Rolled the Foundation Base use, Create My App, install, and customize scaffold across every foundation page while keeping rollout tracking local-only.

  • Added standard-ready install and customize guide routes for every remaining foundation.
  • Kept existing custom metadata for Meditation App, Breathwork, Habit Tracker, and the first rollout batch.
  • Left logos and real screenshot assets pending for the remaining foundations so Charlie can supply controlled assets later.
  • Updated the local-only rollout CSV under `.agents/` instead of restoring any public dashboard.

Bulk template rollout batch deployed

Marked the next small batch of Foundationbase app pages as standard-ready while keeping internal rollout tracking out of the public site.

  • Added the Foundation template standard to Expense Tracker, Subscription Tracker, Workout Log, Recipe Box, and Job Application Tracker.
  • Added logo-pending and screenshot-pending states so pages can adopt the scaffold before final logos and screenshots are supplied.
  • Kept rollout tracking as a local-only maintenance artifact instead of a public dashboard route.

Foundation Base template standard pilot deployed

Deployed the first reusable Use / Install / Create My App / Customize scaffold on selected Foundationbase app pages.

  • Added shared template-standard metadata for Meditation App, Breathwork, and Habit Tracker.
  • Added reusable detail-page sections that explain Demo Links, Preview Links, App Links, ownership, source packages, data behavior, and AI customization.
  • Added route-backed install and customize guides for standard-ready foundations, with Meditation marked as standard-live and the first two non-meditation apps marked standard-ready.
  • Added saved logo and screenshot assets for the pilot foundations and included them in generated source packages.
  • Placed saved logos in the detail-page hero and real Breathwork screenshots into the existing screenshot rail cards.
  • Swapped Breathwork to Charlie's supplied logo and added a reusable asset rollout config/checker for future batches.

Standalone Meditation App prototype deployed

Deployed the packaged Meditation App as its own standalone PWA prototype on a dedicated Firebase Hosting site, separate from the main catalog.

  • Built the generated meditation-app.zip package as a static export and deployed it to the new foundationbase-meditation Hosting site in the same Firebase project.
  • Verified the live app over HTTPS: page, manifest, service worker, offline fallback, icons, and /.well-known/foundationbase.json all serve, with the service worker registering at root scope.
  • Fixed the Hosting ignore config so /.well-known/foundationbase.json is included in deploys of both the standalone site and the main site.

Meditation App pilot prepared

Prepared Meditation App as the first Foundation Base use, install, customize pilot with local-first data, PWA support, and agent customization docs.

  • Added a phone-first meditation timer with local presets, session history, preferences, JSON export/import, confirmed reset, and a Customize this app panel.
  • Added PWA manifest, icons, service worker, offline fallback, and public Foundation Base metadata.
  • Updated the generated download package to include README, QUICKSTART, CUSTOMIZE, DEPLOY, AGENTS, DATA, foundationbase.json, and public PWA assets.

Visitor behavior events wired

Prepared GA4 custom events so Foundationbase can show how visitors search, browse, open demos, and download foundations.

  • Added non-PII events for downloads, demo opens, listing clicks, searches, filters, sort changes, CTAs, contribution-modal opens, copy clicks, and coding-agent tab choices.
  • Documented the GA4 custom dimensions and exploration setup needed to analyze visitor behavior.
  • Kept the change local with status ready until the site is rebuilt, deployed, and verified in production.

History feed added

Added a public update feed and agent maintenance rules so Foundationbase changes are easier to follow.

  • Created a structured history source that can be reviewed and extended by future agents.
  • Added a public /history page with release, site, catalog, quality, and operations updates.
  • Updated agent instructions so Claude and Codex keep the feed current when user-visible work ships.

Analytics wiring prepared

Added optional analytics plumbing for the Firebase-hosted site while keeping local builds free of required analytics secrets.

  • Added global analytics integration with a GA4 default and environment override support.
  • Documented Cloudflare Web Analytics and GA4 setup in the repo.
  • Verified the live production pages returned 200 and included the GA4 measurement ID.

Combined production deploy

Landed the contribution intake work and several app/site upgrades together on the Firebase-hosted production site.

  • Verified foundationbase.app with the 27-foundation catalog, real hero search, PixelPal, live embeds, and /contribute.
  • Confirmed selected demo pages and download zips served successfully after deploy.
  • Published the combined work from the recent Codex and Claude changes.

Four niche foundations added

Expanded the catalog with focused, search-friendly foundations for baby tracking, car maintenance, reading, and debt payoff planning.

  • Added Baby Tracker with one-tap feeds, sleep, diapers, and checkup-ready history.
  • Added Car Maintenance Log with due-soon mileage logic and lifetime spend.
  • Added Book Tracker and Debt Payoff Planner with real progress and payoff math.

SEO and detail-page UX sweep

Improved discovery and detail-page confidence with real search, breadcrumbs, embedded demos, and richer structured data.

  • Turned the hero search into a working GET form for /browse.
  • Embedded click-to-load live demos directly on foundation detail pages.
  • Added visible breadcrumbs and ItemList/CollectionPage structured data.

Pixel layer and hidden retro mode

Added lighthearted visual flourishes while preserving the calm default site experience.

  • Added PixelPal to the hero and subtle pixel motion on key interactive elements.
  • Added a hidden retro mode with session persistence and reduced-motion support.
  • Added download-click confetti for real download links.

Breathwork and Garmin Watch Kit added

Added a wellness app foundation and a developer-tool foundation for Garmin watch-face starters.

  • Added Breathwork with paced breathing patterns and private session history.
  • Added Garmin Watch Kit with a visual watch-face designer and generated Monkey C starter files.
  • Verified both passed the submission checker and built cleanly.

Demo app depth upgrades

Made several existing foundations feel more complete by adding real workflow depth and verified calculations.

  • Expanded Travel Planner, Workout Log, Habit Tracker, Newsletter, Bug Tracker, Expense Tracker, and Recipe Box.
  • Added practical features like budgets, stats, CSV export, comments, favorites, scaling, and bulk import.
  • Verified core math and interaction paths in-browser before release.

Contribution intake and security model

Built the first contributor path around real packages, automated checks, and explicit safety expectations.

  • Reworked /contribute and contributor docs around manifest-based foundation submissions.
  • Added starter templates and automated submission validation.
  • Extended the checker with static manifest, dependency, lifecycle, banned-pattern, storage, asset, and likely-secret rules.

Agent coordination setup

Added the shared agreement and handoff files that let Codex and Claude work in the repo without trampling each other.

  • Added AGENTS.md, CLAUDE.md, .agents/PROJECT_STATE.md, and .agents/HANDOFF.md.
  • Documented Firebase Hosting as the deployment target and Cloudflare as DNS-only.
  • Established the rule that no fake links, metrics, downloads, or placeholder product claims ship.