Fluxgo public website
This repository contains the Fluxgo public website and the admin portal, built with Next.js.
Structure
app/(site)/ holds the public pages: home, /support, and /privacy-terms. They share app/(site)/site.css and the parts in app/(site)/_components/. All public styles sit under the .fx root class.app/admin-portal/ holds the operations console. Its styles are in app/admin-portal/admin.css and load only on that route.- The public pages use SVG and CSS for all visuals. Colors mirror
fluxgo-frontend/src/constants/tokens.json.
Local development
Install the dependencies, then start the development server.
npm install
npm run dev
Open http://localhost:3000 in your browser.
Vercel
Import fluxgo-org/fluxgo-website into Vercel.
- Framework preset: Next.js
- Root directory:
./
- Build command: automatic
- Output directory: automatic
- Install command: automatic
Vercel detects Next.js from package.json. Add fluxgo.in as the custom domain after the first deployment.
Admin portal
Open /admin-portal to use the operations console.
The portal calls the backend admin routes with credentials: include. The
backend owns the session in an HttpOnly cookie. The browser does not store an
admin bearer token or password. Set NEXT_PUBLIC_FLUXGO_API_URL to the
approved API origin, such as http://127.0.0.1:3000 for local development or
the deployed API origin for the hosted website.
The console has a Today page (work that needs an admin, 7-day trends), a support
inbox with owners, internal notes, and templates, and tables for members, rides,
bookings, safety reports, manual vehicles, and the audit log. Tables support
column resize, column visibility, server sorting, advanced filters, quick views,
and CSV export. Record panels link members, rides, bookings, and tickets. Admins
can suspend or reactivate members, cancel published rides, and send
notifications. Admins sign in with email only.
The portal does not poll each view. It checks GET /v1/admin/dashboard/pulse
every 60 s (15 s in an open support chat), pauses while the tab is hidden or
after 10 min without input, and reloads only views whose data changed.
The portal is an installable web app (public/admin/manifest.webmanifest, scope /admin-portal). public/admin-sw.js only shows admin push notifications and opens the linked page on tap; it does not cache pages or data. Turn notifications on per device in the sidebar under Notifications. On iPhone, push works only after Safari Add to Home Screen (iOS 16.4+).
For a local preview with made-up data, run npm run dev:admin-mock and start
next dev with NEXT_PUBLIC_FLUXGO_API_URL=http://localhost:4010. Sign in with
[email protected] and preview-password. The mock uses no real data.
The reset form accepts the one-time code from the admin email. It also accepts
resetToken in the URL query for a future email-link template.
Shared ride links
/ride/:publicId shows a public ride that a member shared from the app. It reads GET /v1/public/trips/:publicId and refreshes the data every 60 s. It has a per-ride preview image and noindex.
FLUXGO_API_URL: API base for server fetches. Default https://api.fluxgo.in.NEXT_PUBLIC_FLUXGO_OPEN_HOST_URL: host for the "Open in app" button. Default https://go.fluxgo.in. It must be a different domain from the page, or iOS does not open the app.
/.well-known/apple-app-site-association and /.well-known/assetlinks.json let the app open /ride/* and /open/ride/*. Serve them on www.fluxgo.in and go.fluxgo.in with no redirect. /open/ride/:publicId sends a visitor without the app to the App Store or Google Play. A computer goes to the web app. Ride pages show one button: open the app on a phone, or continue on the web on a computer.
