Skip to content

release: v0.1.0#12

Merged
roncodes merged 8 commits into
mainfrom
release/v0.1.0
May 11, 2026
Merged

release: v0.1.0#12
roncodes merged 8 commits into
mainfrom
release/v0.1.0

Conversation

@roncodes
Copy link
Copy Markdown
Member

First Fleetbase-versioned release of fleetbase.io. Bundles three pending PRs and establishes versioning conventions going forward.

Bundled PRs

Each was merged with --no-ff so the original PR commits are preserved in history.

Conventions established

  • Package: renamed plasma-nextjs-templatefleetbase.io, version reset to 0.1.0.
  • Versioning: Semantic Versioning. Pre-1.0 means breaking changes can land in minor bumps.
  • CHANGELOG: Keep a Changelog format — a ## [X.Y.Z] - YYYY-MM-DD section per release.
  • Release workflow: .github/workflows/release.yml triggers on v*.*.* tag push. It validates the tag matches package.json version, extracts the matching CHANGELOG section, and publishes a GitHub Release. Pre-release tags (-beta.1, -rc.1) are auto-flagged.

Cutting future releases

  1. Create a release/vX.Y.Z branch from main.
  2. Merge in the PRs you want to ship.
  3. Bump package.json version. Add a ## [X.Y.Z] section to CHANGELOG.md.
  4. Open a PR to main. Review, merge.
  5. git checkout main && git pull && git tag vX.Y.Z && git push origin vX.Y.Z
  6. The release workflow publishes the GitHub Release automatically.

Post-merge follow-ups

🤖 Generated with Claude Code

vercel Bot and others added 8 commits May 10, 2026 01:20
# Vercel Web Analytics Installation

Successfully installed and configured Vercel Web Analytics for this Next.js project.

## Changes Made

### 1. Package Installation
- Added `@vercel/analytics` package (v2.0.1) using pnpm
- Package was installed following the latest official Vercel documentation

### 2. Code Changes
**Modified: `src/app/layout.tsx`**
- Added import: `import { Analytics } from '@vercel/analytics/next';`
- Added `<Analytics />` component inside the `<body>` tag, after the `</ThemeProvider>` closing tag
- Placement ensures Analytics loads on all pages while respecting the existing provider hierarchy

### 3. Dependencies Updated
**Modified: `package.json`**
- Added `@vercel/analytics` to dependencies

**Modified: `pnpm-lock.yaml`**
- Lockfile updated to include @vercel/analytics and its dependencies

## Implementation Details

Following the official Vercel Analytics quickstart guide (https://vercel.com/docs/analytics/quickstart), the implementation uses the Next.js App Router pattern:

1. The Analytics component is imported from `@vercel/analytics/next` (the framework-specific export)
2. The component is placed inside the root layout's `<body>` tag
3. This ensures analytics tracking is active on all pages across the application

## Verification

- ✅ No linting errors introduced in `src/app/layout.tsx`
- ✅ Package successfully installed via pnpm
- ✅ Import statement follows Next.js App Router conventions
- ✅ Component placement preserves existing layout structure
- ✅ Lock file updated correctly

## Notes

- The build step requires Ghost blog environment variables (GHOST_API_URL, GHOST_CONTENT_API_KEY) which are unrelated to this change
- Once deployed to Vercel, analytics will automatically start collecting data
- No additional configuration is required in the code
- Analytics can be viewed in the Vercel dashboard after enabling the feature

## Post-Deployment Steps

After deployment, you should:
1. Enable Analytics in your Vercel project dashboard (Analytics → Enable)
2. Verify implementation by checking the Network tab for requests to `/_vercel/insights/*`
3. View analytics data in the Vercel dashboard

Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com>
Each docs section layout passes nav={{ enabled: false }} to fumadocs
DocsLayout to avoid duplicating the site Navbar. That also removes
fumadocs's mobile SidebarTrigger, which lived inside the disabled nav,
leaving the sidebar drawer (section picker + page tree) unreachable
below the md breakpoint.

Add a DocsSidebarTrigger client component that calls useSidebar() from
fumadocs's RootProvider context, and render it in the site Navbar's
existing mobile cluster. It only mounts on /docs routes and only at
viewports below md, where the desktop sidebar is hidden.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Reworks the mobile nav pattern on /docs so users get one hamburger
trigger instead of two stacked icons. The site hamburger opens the
fumadocs sidebar; inside it, a "Main menu →" button overlays the site
nav drawer on top. Closing peels one layer at a time. On non-docs
routes the hamburger behaves as before.

While in there, two real bugs:

- The site drawer used to render as a child of <header>. When the
  header gets backdrop-blur (scrolled state), it establishes a new
  containing block for position:fixed descendants — the drawer's
  inset-0 collapses to the header's tiny vertical box and renders
  invisible. Drawer now portals to document.body via createPortal.

- Scroll lock used overflow:hidden on <html>, which strips
  position:sticky of its scrolling ancestor and drops the header out
  of the viewport when the menu opens after scrolling. Switched to
  overflow:clip — same lock, no scroll container established, sticky
  preserved.

Plus a 1rem top-padding rule on #nd-sidebar-mobile (banner was flush
against the header) and a small MobileNavProvider context so the
"Main menu →" button inside the docs sidebar can drive site-drawer
state from inside <main>.

Deletes the standalone DocsSidebarTrigger introduced in #9 — that
dual-icon approach is superseded by the stacked-drawer pattern.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Rename package.json from "plasma-nextjs-template" to "fleetbase.io"
  and reset version to 0.1.0 (first Fleetbase-versioned release).
- Add CHANGELOG.md following Keep a Changelog conventions.
- Add .github/workflows/release.yml — pushing a vX.Y.Z tag publishes a
  GitHub Release whose body is the matching CHANGELOG section. Validates
  package.json version matches the tag and refuses to release if no
  CHANGELOG entry exists for the version. Pre-release tags (e.g.
  v1.0.0-rc.1) are auto-flagged as pre-releases.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
fleetbase-io Ready Ready Preview, Comment May 11, 2026 2:10am

Request Review

@roncodes roncodes merged commit 5b2c3f3 into main May 11, 2026
2 checks passed
@roncodes roncodes deleted the release/v0.1.0 branch May 11, 2026 02:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant