docs: add Makefile, update README with run commands, fix community refs

- Add Makefile with setup, dev, build, lint, and clean targets
- Update README Quick Start to use make commands with full command table
- Update CONTRIBUTING.md dev setup to reference Makefile
- Fix CODE_OF_CONDUCT.md to reference CopilotKit community consistently

Author: GeneralJerel

CODE_OF_CONDUCT.md

@@ -22,7 +22,7 @@ Open Generative UI is an open-source showcase and template for building rich, in
 
 ## 2. Community Values
 
-At Open Generative UI and across the CopilotKit ecosystem, we prioritize the following values:
+At CopilotKit, we prioritize the following values:
 
 | **Value**         | **Description**                                                                                            |
 | ----------------- | ---------------------------------------------------------------------------------------------------------- |
@@ -35,7 +35,7 @@ At Open Generative UI and across the CopilotKit ecosystem, we prioritize the fol
 
 ## 3. Expected Behavior
 
-As a participant in the Open Generative UI community, you are expected to:
+As a participant in the CopilotKit community, you are expected to:
 
 - **Be Respectful and Inclusive**: Treat all individuals with respect and kindness, regardless of their background, identity, or experience level.
 - **Communicate Constructively**: Engage in discussions that are constructive, focusing on ideas and solutions rather than personal opinions.
@@ -94,7 +94,7 @@ Consequences for violating the Code of Conduct will be determined based on the s
 
 ## 7. Scope
 
-This Code of Conduct applies to all participants in the Open Generative UI community, including contributors, maintainers, and users, both online and offline. It encompasses interactions in the following areas:
+This Code of Conduct applies to all participants in the CopilotKit community, including contributors, maintainers, and users, both online and offline. It encompasses interactions in the following areas:
 
 - GitHub discussions and issues on the [open-generative-ui](https://github.com/CopilotKit/open-generative-ui) repository
 - The broader [CopilotKit Discord](https://discord.gg/6dffbvGU3D)

CONTRIBUTING.md

@@ -49,36 +49,55 @@ This is a **Turborepo monorepo** with a Next.js frontend and a LangGraph Python
 
 > **Windows users:** Enable **Developer Mode** (Settings > System > For developers > Developer Mode → On) to allow symlink creation. This is required for Next.js standalone builds and pnpm to work correctly.
 
-### 2) Install Dependencies
+### 2) Install Dependencies and Set Up
+
+The quickest way to get started is with the Makefile:
 
 ```bash
-pnpm install
+make setup    # Installs deps + creates .env template
 ```
 
-### 3) Set Up Environment Variables
+Or manually:
 
 ```bash
-# Add your OpenAI API key for the agent
+pnpm install
 echo 'OPENAI_API_KEY=your-key-here' > apps/agent/.env
 ```
 
-### 4) Start Development
+Then add your real OpenAI API key to `apps/agent/.env`.
+
+### 3) Run the Project
+
+```bash
+make dev      # Start all services (frontend + agent + mcp)
+```
+
+Or run services individually:
 
 ```bash
-# Start all services (frontend + agent)
-pnpm dev
+make dev-app    # Next.js frontend on http://localhost:3000
+make dev-agent  # LangGraph agent on http://localhost:8123
+make dev-mcp    # MCP server
+```
 
-# Or start individually:
-pnpm dev:app    # Next.js frontend on http://localhost:3000
-pnpm dev:agent  # LangGraph agent on http://localhost:8123
+You can also use `pnpm` directly:
+
+```bash
+pnpm dev          # All services
+pnpm dev:app      # Frontend only
+pnpm dev:agent    # Agent only
 ```
 
-### 5) Build
+### 4) Build and Lint
 
 ```bash
-pnpm build
+make build    # Build all apps
+make lint     # Lint all apps
+make clean    # Clean build artifacts
 ```
 
+Run `make help` to see all available commands.
+
 ## Step 4: Create a branch
 
 Create a new branch for your changes.

Makefile

@@ -0,0 +1,36 @@
+.PHONY: help install setup dev dev-app dev-agent dev-mcp build lint clean
+
+help: ## Show this help message
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install all dependencies (Node + Python)
+	pnpm install
+
+setup: install ## Full setup: install deps and create .env from template
+	@if [ ! -f apps/agent/.env ]; then \
+		echo "OPENAI_API_KEY=your-key-here" > apps/agent/.env; \
+		echo "Created apps/agent/.env — add your OpenAI API key"; \
+	else \
+		echo "apps/agent/.env already exists, skipping"; \
+	fi
+
+dev: ## Start all services (frontend + agent + mcp)
+	pnpm dev
+
+dev-app: ## Start Next.js frontend only (http://localhost:3000)
+	pnpm dev:app
+
+dev-agent: ## Start LangGraph agent only (http://localhost:8123)
+	pnpm dev:agent
+
+dev-mcp: ## Start MCP server only
+	pnpm dev:mcp
+
+build: ## Build all apps
+	pnpm build
+
+lint: ## Lint all apps
+	pnpm lint
+
+clean: ## Clean build artifacts
+	pnpm clean

README.md

@@ -18,19 +18,30 @@ All visuals are rendered in sandboxed iframes with automatic light/dark theming,
 ## Quick Start
 
 ```bash
-# Install dependencies
-pnpm install
-
-# Add your OpenAI API key
-echo 'OPENAI_API_KEY=your-key' > apps/agent/.env
-
-# Start all services
-pnpm dev
+make setup    # Install deps + create .env template
+# Edit apps/agent/.env with your real OpenAI API key
+make dev      # Start all services
 ```
 
 - **App**: http://localhost:3000
 - **Agent**: http://localhost:8123
 
+### Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `make setup` | Install all dependencies and create `.env` template |
+| `make dev` | Start all services (frontend + agent + mcp) |
+| `make dev-app` | Start Next.js frontend only |
+| `make dev-agent` | Start LangGraph agent only |
+| `make dev-mcp` | Start MCP server only |
+| `make build` | Build all apps |
+| `make lint` | Lint all apps |
+| `make clean` | Clean build artifacts |
+| `make help` | Show all available commands |
+
+You can also use `pnpm` directly (`pnpm dev`, `pnpm dev:app`, `pnpm dev:agent`, etc.).
+
 ## Architecture
 
 Turborepo monorepo with two apps: