AI Workforce Studio

AI Workforce Studio is a Next.js and Firebase workspace for managing AI-assisted team operations. It combines task planning, meeting support, admin workflows, billing, and developer tooling in a single dashboard-style application.

Features

• AI task manager with backlog, to-do, in-progress, and done columns
• Priority prediction flow that scores new tasks from urgency, importance, and complexity
• Meeting workspace for transcript processing and AI-generated summaries
• Developer assist area for code-generation workflows
• Firebase-backed client and server integration
• Dashboard routes for billing, settings, admin, and help flows

Tech Stack

• Next.js 15 with the App Router
• TypeScript
• Tailwind CSS and Radix UI components
• Firebase client SDK and Firebase Functions
• Genkit and OpenAI integrations for AI workflows

Project Structure

src/
  app/           Next.js routes and dashboard pages
  ai/            Frontend AI flows and Genkit wiring
  components/    Shared UI and layout components
  firebase/      Client-side Firebase setup and hooks
functions/
  src/           Firebase Functions for webhooks, summaries, and scheduling
docs/            Product and backend planning notes

Getting Started

Prerequisites

• Node.js 20 or newer
• npm
• A Firebase project if you want to run the hosted features end to end

Environment Variables

Create a local .env file from .env.example and fill in the values for your Firebase project and AI providers.

copy .env.example .env

Frontend variables:

• NEXT_PUBLIC_FIREBASE_PROJECT_ID
• NEXT_PUBLIC_FIREBASE_APP_ID
• NEXT_PUBLIC_FIREBASE_API_KEY
• NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN
• NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID
• NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID
• GEMINI_API_KEY

Backend variables:

• OPENAI_API_KEY

Install dependencies

npm install
cd functions && npm install

Run the web app

npm run dev

Useful scripts

npm run typecheck
npm run build
npm run genkit:dev

For Firebase Functions:

cd functions
npm run build

Deployment

Web App

The Next.js app can be deployed to Firebase App Hosting, Vercel, or another Node-compatible hosting provider.

Recommended production checklist:

• configure all environment variables before deployment
• verify Firebase Auth and Firestore rules for your target project
• review generated AI routes before exposing them publicly
• add analytics and error monitoring for production debugging

Firebase Functions

Deploy functions only after setting OPENAI_API_KEY in your Firebase environment or secret manager.

cd functions
npm run build
firebase deploy --only functions

Environment Notes

Do not commit live credentials. Keep local .env files out of version control and store production secrets in your hosting platform or Firebase-managed secrets.

Current Status

This project already includes the main dashboard UI and supporting AI/Firebase scaffolding. Some backend capabilities, such as the Dev Assist endpoint, are still scaffolded and ready for fuller implementation.

Portfolio Positioning

If you are using this repository as a showcase project, highlight it as:

• an AI operations dashboard built with Next.js and Firebase
• a product prototype that combines task intelligence, meeting summaries, and developer tooling
• a full-stack TypeScript project with frontend UX and backend automation scaffolding