HaritaDocs

HaritaDocs is a Next.js 14 workspace for IGBC Green Interiors documentation collection, review, and submission packaging. It is built around the real CCIL documentation tracker and the IGBC Green Interiors v2 reference guide supplied for this build.

The current UI is intentionally dense and operational rather than marketing-led:

• A slim dashboard header with KPI strip and inline project creation
• Full-width project rows with quick workspace and submission actions
• A three-column project workspace with category rail, dense credit table, and right-side detail panel
• Plain consultant-facing copy in demo states instead of exposing internal implementation terms

Fast onboarding

Harita now ships as a public npm package and a local app copy:

• Package name: harita-studio
• CLI command: harita

Recommended install flow for consultants:

npm install -g harita-studio

Then run harita from inside the Harita folder they received.

You can also scaffold a fresh folder directly:

npx harita-studio

What the launcher does:

1. Runs npm install if needed
2. Prompts for one Gemini API key
3. Creates .env.local with demo-safe defaults
4. Shows a first-time tour of what Harita can do
5. Lets the user choose what they want to do: review, upload, or prepare the final package
6. Launches the app with local sample data
7. If run in an empty folder, scaffolds the Harita workspace there first

Install does not auto-open a TUI. The launcher starts after you run harita or npx harita-studio, so npm install stays non-interactive.

Publish to npm

To publish this package to the public npm registry:

npm login
npm publish --access public

The package is now unscoped, so it can be published directly with npm publish.

For repeat releases from the repo checkout, you can also run:

npm run publish:public

If you want a private registry instead, add a project .npmrc with the registry URL you want to use and publish against that registry.

For a local repo checkout, the same launcher is also available via:

npm run onboard

Stack

• Next.js 14 App Router
• Supabase Auth, Postgres, Storage, Realtime-compatible notifications
• Tailwind CSS + shadcn-style component structure
• XLSX export via xlsx
• ZIP submission pack via jszip
• PDF summary via pdf-lib
• Guided onboarding via a Node-based CLI
• Playwright smoke verification

Setup

The default mode is local/demo, so consultants do not need to create a Supabase project.

1. Install the package globally or run the local launcher
2. Enter a Gemini API key
3. Open the app in the generated workspace

If you are developing the app itself, you can still run npm install and npm run dev directly.

Guided commands

• harita Runs the one-key onboarding launcher and guided tour.
• npm run onboard Runs the same launcher from the repo checkout.
• npm run dev:guided Starts the app, waits for /login, opens the browser automatically, and can run the smoke test.
• npm run smoke Runs the prebuilt Playwright smoke test.

Database notes

• The seeded IGBC catalog lives in data/igbc-green-interiors-v2.json
• The credit matrix is derived from the CCIL tracker workbook you provided, not hand-entered
• The tracker source produces 47 seeded rows including mandatory requirements, which differs from the original 42-credit note in the prompt

Environment defaults

The onboarding wizard now writes the following automatically:

• GEMINI_API_KEY
• AI_PROVIDER=gemini
• AI_MODEL=gemini-2.5-flash
• APP_MODE=demo
• demo-safe defaults for the remaining variables

The app still falls back to demo mode if Supabase credentials are not present.

Seed command

npm run seed -- "HaritaDocs Seed Project" Gold <owner-user-id>

• Creates a test project
• Seeds the full credit catalog
• Optionally adds one owner membership if a Supabase auth.users.id is provided

Product surfaces

• /login Email/password sign-in for the live workspace, with a seeded demo fallback when the live database is not connected.
• /dashboard Dense consultant dashboard with KPI strip, inline project creation, and compact project rows.
• /projects/[id] Three-column workspace with category navigation, dense credit table, status/doc requirement chips, upload/review actions, and remarks.
• /projects/[id]/submission Completed-credit submission view with approved document list and ZIP export gating based on mandatory credits.

Exports

• /api/projects/[id]/tracker CCIL-style XLSX export.
• /api/projects/[id]/summary PDF summary export.
• /api/projects/[id]/submission-pack ZIP export of approved documents.