⚡ Pravah

Pravah is an open-source workflow automation platform that enables teams to design, execute, and manage workflows across multiple services from a single interface.

It is built with a React + Vite frontend, a lightweight Express server, and a modular integration layer (flowconnect/) supporting messaging, CRM, forms, invoicing, and payment systems.

---

🚀 NSOC '26 Participation

Pravah is an official project in Nexus Spring of Code 2026 (NSOC '26).

• 👨‍💻 Role: Project Admin
• 🤝 Open for contributors
• 🎯 Focus Areas:
  • Workflow automation engine
  • Integration ecosystem
  • Frontend UX improvements
  • Backend scalability

---

✨ Features

• 🔄 Visual workflow builder
• 🔌 Plug-and-play integrations (Slack, Discord, Telegram, Zoho, Airtable, Razorpay, Typeform, Tally, etc.)
• 🧠 Local-first architecture (no external DB required)
• 🔐 Built-in authentication backend
• 📊 Dashboard with workflow insights
• ⚙️ Enable/disable workflows dynamically
• 🧩 Extensible integration system

---

🧩 Architecture

Frontend (React + Vite) ↓ Express Server (Production Hosting) ↓ Local Auth Backend (JSON Storage) ↓ Integration Layer (flowconnect/)

---

📁 Project Structure

├── .github/ 
├── flowconnect/ 
├── public/ 
│
├── src/ 
│ ├── api/
│ ├── assets/
│ ├── components/
│ ├── context/
│ ├── pages/
│ ├── styles/
│ ├── utils/
│ ├── App.tsx
│ └── main.tsx
│
├── .gitignore
├── index.html 
├── index.js 
│
├── package.json
├── package-lock.json
├── eslint.config.js
├── postcss.config.js
│
├── README.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── ACCESSIBILITY.md
├── ARCHITECTURE.md
├── INTEGRATIONS.md
├── LICENSE

---

🚀 Quick Start

Prerequisites

• Node.js ≥ 20
• npm ≥ 10

Step 1: Clone & Install

git clone https://github.com/Priyanshisharma22/flowconnect.git
cd flowconnect
npm install

Step 2: Setup Environment Variables

# Copy the example file
cp .env.example .env

# Edit .env and add your API keys for services you want to use
# See INTEGRATIONS.md for details on each service

Required variables:

• VITE_API_BASE_URL=http://localhost:5000
• AUTH_SERVER_PORT=5000
• JWT_SECRET=your_jwt_secret_key_here

Optional: Add API keys only for services you plan to use (Slack, Discord, Zoho, etc.)

Step 3: Start the Development Server

Terminal 1 - Frontend:

npm run dev
# Opens http://localhost:5173

Terminal 2 - Auth Backend:

npm run auth:server
# Runs on http://localhost:5000

Step 4: Access the Application

Open http://localhost:5173 in your browser.

Default test credentials:

• Email: test@example.com
• Password: password123

Production Mode

npm run build    # Build frontend
npm start        # Start Express server

---

📚 Documentation

• ARCHITECTURE.md - System design & data flows
• INTEGRATIONS.md - MCP services & setup guide
• CONTRIBUTING.md - How to contribute & folder structure
• .env.example - All environment variables

---

📜 Scripts

Command Description

npm run dev Start frontend (Vite) npm run auth:server Start local auth backend npm run mcp:server Start MCP tool server for AI agents npm run server Start Express server (nodemon) npm run build Build frontend npm run lint Run ESLint

---

🔌 Integrations

Located in flowconnect/, including:

Messaging → Slack, Discord, Telegram

CRM → Zoho, Airtable

Payments → Razorpay

Forms → Typeform

Accounting → Tally

Each module is independently extendable.

---

🤖 MCP Server (AI Agent Tools)

Pravah exposes all integrations as Model Context Protocol tools, allowing AI agents (Claude Desktop, Cursor, etc.) to trigger Pravah workflows directly.

Start the server:

npm run mcp:server

29 tools across 6 services:

Service	Tools
Slack	slack_send_message, slack_send_payment_alert, slack_send_notification, slack_send_block
Discord	discord_send_message, discord_send_payment_alert, discord_send_embed, discord_send_notification
Telegram	telegram_send_message, telegram_send_payment_alert, telegram_get_bot_info, telegram_get_updates
Razorpay	razorpay_get_todays_payments, razorpay_get_payments_by_range, razorpay_get_payment_details, razorpay_get_payment_summary
Airtable	airtable_add_payment, airtable_get_payments, airtable_add_record, airtable_get_records, airtable_update_record, airtable_search_records
Zoho CRM	zoho_create_lead, zoho_create_contact, zoho_create_deal, zoho_create_task, zoho_get_leads, zoho_search_leads, zoho_update_lead

Tools for services without credentials set are automatically skipped at startup.

Connect to Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pravah": {
      "command": "node",
      "args": ["/absolute/path/to/flowconnect/flowconnect/mcp/server.js"],
      "env": {
        "SLACK_WEBHOOK_URL": "your_slack_webhook",
        "RAZORPAY_KEY_ID": "your_key_id"
      }
    }
  }
}

See .env.example for all available environment variables.

---

🤝 Contributing

We welcome contributions, especially during NSOC '26.

Steps

1. Read CONTRIBUTING.md

2. Choose an issue from .github/ISSUE_TEMPLATE

3. Fork the repository

4. Create a feature branch

5. Submit a pull request

Also review:

SECURITY.md

CODE_OF_CONDUCT.md

---

⚠️ Notes

Some integrations require API keys and local setup

Runtime-generated files are ignored where possible

Designed for extensibility — add custom integrations inside flowconnect/

---

📄 License

• License

💡 Vision

Pravah aims to be a developer-first alternative to n8n and Zapier, with:

Open architecture

Local-first execution

High customizability

Scalable integration ecosystem

---

👨‍💻 Maintainers

Priyansh Chaurasiya – Full Stack Developer

Priyanshi Sharma – Machine Learning Engineer | Full Stack Developer

---