FlowState Pro by Uriesmooth

FlowState Pro is a modular flow platform built for teams that ship fast. Build, connect, and deploy intelligent pipelines in minutes using a visual composer, with the flexibility to drop into custom code anytime. Scale easily, stay secure, and streamline your workflow seamlessly.

🌐 Live Demo: wooden-slick-flow-pro.base44.app

✨ Features

Core Capabilities

Visual Composer - Drag-and-drop pipeline builder with intuitive UI
Modular Architecture - Reusable components for rapid development
Custom Code Integration - Drop into custom JavaScript/Python anytime
Team Collaboration - Real-time collaboration for distributed teams
Scalable Infrastructure - Handle millions of pipeline executions

Enterprise Features

Enterprise Security - Built-in authentication, encryption, and compliance
Rich Integrations - Connect with 100+ third-party services
API-First Design - Powerful REST and GraphQL APIs
Advanced Analytics - Monitor pipelines and execution metrics
Multi-tenant Support - Isolate teams and organizations

Developer Experience

No-Code & Low-Code - Visual builder with custom code escape hatch
Pre-built Nodes - 50+ ready-to-use components
Node Library - Create and share custom nodes
Version Control - Track changes and rollback easily
Local Development - SDK for local testing and development

🚀 Quick Start

Prerequisites

Node.js 18.0.0 or higher
npm 9.0.0 or higher
Git for version control
Optional: Docker for containerized deployment

Installation

1. Clone the Repository

git clone https://github.com/uriesmooth/Uriesmooth-.git
cd Uriesmooth-

2. Install Dependencies

npm install

3. Configure Environment

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

# Edit .env with your configuration
# nano .env

4. Start Development Server

npm run dev

5. Access the Application

Open your browser and navigate to:

http://localhost:3000

First Pipeline

Once you're logged in:

Click "Create Pipeline"
Add nodes by dragging from the sidebar
Connect nodes to create your flow
Click "Deploy" to activate
Monitor execution in the Dashboard

📚 Documentation

Getting Started Guides

Installation Guide - Detailed setup instructions
Quick Start Tutorial - Build your first pipeline in 5 minutes
Configuration Guide - Environment setup and customization

Core Concepts

Pipelines - Understand pipeline structure
Flows & Nodes - Core building blocks
Triggers - How to trigger pipelines
Actions - Execute tasks and integrations

API Reference

REST API - RESTful API documentation
GraphQL API - GraphQL schema and queries
Webhooks - Incoming and outgoing webhooks
SDK Reference - JavaScript/TypeScript SDK

Advanced Topics

Custom Nodes - Build your own nodes
Deployment Strategies - Production deployment
Performance Optimization - Scaling pipelines
Security Best Practices - Security hardening

Examples

Data Processing - ETL pipelines
Webhook Integration - Real-time integrations
Scheduled Tasks - Cron-style scheduling
Error Handling - Robust error management

🏗️ Project Structure

Uriesmooth-/
├── src/                          # Source code
│   ├── components/               # Reusable UI components
│   │   ├── pipeline/
│   │   ├── nodes/
│   │   ├── canvas/
│   │   └── shared/
│   ├── pages/                    # Application pages
│   │   ├── dashboard/
│   │   ├── pipelines/
│   │   ├── settings/
│   │   └── auth/
│   ├── api/                      # API routes & handlers
│   │   ├── auth/
│   │   ├── pipelines/
│   │   ├── executions/
│   │   └── integrations/
│   ├── services/                 # Business logic
│   │   ├── pipeline.service.js
│   │   ├── execution.service.js
│   │   └── integration.service.js
│   ├── utils/                    # Utility functions
│   │   ├── validators/
│   │   ├── formatters/
│   │   └── helpers/
│   ├── styles/                   # Global styles
│   │   ├── variables.scss
│   │   ├── globals.scss
│   │   └── themes/
│   ├── config/                   # Configuration
│   │   ├── database.js
│   │   ├── redis.js
│   │   └── logger.js
│   └── middleware/               # Express middleware
│       ├── auth.js
│       ├── errorHandler.js
│       └── requestLogger.js
│
├── public/                       # Static assets
│   ├── images/
│   ├── icons/
│   └── fonts/
│
├── docs/                         # Documentation
│   ├── concepts/
│   ├── api/
│   ├── advanced/
│   └── examples/
│
├── tests/                        # Test suites
│   ├── unit/
│   ├── integration/
│   └── e2e/
│
├── .github/                      # GitHub configuration
│   ├── workflows/                # CI/CD pipelines
│   ├── ISSUE_TEMPLATE/
│   └── PULL_REQUEST_TEMPLATE/
│
├── config/                       # Configuration files
│   ├── webpack.config.js
│   ├── jest.config.js
│   └── eslint.config.js
│
├── docker/                       # Docker files
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── .dockerignore
│
├── k8s/                          # Kubernetes manifests
│   ├── deployment.yaml
│   ├── service.yaml
│   └── configmap.yaml
│
├── .env.example                  # Environment template
├── .gitignore                    # Git ignore rules
├── .dockerignore                 # Docker ignore rules
├── package.json                  # Dependencies & scripts
├── package-lock.json             # Locked versions
├── Dockerfile                    # Container image
├── docker-compose.yml            # Local development compose
├── LICENSE                       # MIT License
├── CONTRIBUTING.md               # Contribution guidelines
├── SECURITY.md                   # Security policy
└── README.md                     # This file

🛠️ Tech Stack

Frontend

Technology	Purpose
React 18	UI Framework
Redux Toolkit	State Management
Tailwind CSS	Styling
React Query	Data Fetching
React Flow	Node-based Editor
TypeScript	Type Safety

Backend

Technology	Purpose
Node.js	Runtime
Express.js	Web Framework
PostgreSQL	Primary Database
Redis	Caching & Queue
Socket.io	Real-time Communication
JWT	Authentication

DevOps & Tools

Technology	Purpose
Docker	Containerization
Kubernetes	Orchestration
GitHub Actions	CI/CD
Jest	Testing
ESLint	Linting
Prettier	Code Formatting

📖 Usage Examples

Example 1: Create a Data Processing Pipeline

import { FlowState } from '@flowstate/sdk';

const flowstate = new FlowState({
  apiKey: 'your-api-key',
  baseUrl: 'https://api.flowstate.io'
});

// Create a pipeline
const pipeline = await flowstate.pipelines.create({
  name: 'Daily Data Sync',
  description: 'Sync data from API to database',
  
  nodes: [
    {
      id: 'webhook-trigger',
      type: 'trigger',
      config: {
        event: 'webhook',
        path: '/data-sync'
      }
    },
    {
      id: 'fetch-data',
      type: 'http',
      config: {
        method: 'GET',
        url: 'https://api.example.com/data',
        headers: { 'Authorization': 'Bearer token' }
      }
    },
    {
      id: 'transform',
      type: 'transform',
      config: {
        script: `
          return data.map(item => ({
            id: item.id,
            name: item.title,
            updated_at: new Date()
          }));
        `
      }
    },
    {
      id: 'save-to-db',
      type: 'database',
      config: {
        provider: 'postgresql',
        table: 'data_sync',
        action: 'upsert'
      }
    }
  ],
  
  connections: [
    { from: 'webhook-trigger', to: 'fetch-data' },
    { from: 'fetch-data', to: 'transform' },
    { from: 'transform', to: 'save-to-db' }
  ]
});

console.log('Pipeline created:', pipeline.id);

Example 2: Deploy to Docker

# Build the Docker image
docker build -t flowstate-pro:v1.0.0 .

# Run the container
docker run -p 3000:3000 \
  -e NODE_ENV=production \
  -e DATABASE_URL=postgresql://user:pass@host:5432/db \
  -e JWT_SECRET=your-secret-key \
  flowstate-pro:v1.0.0

# Push to Docker Hub
docker login
docker tag flowstate-pro:v1.0.0 yourusername/flowstate-pro:v1.0.0
docker push yourusername/flowstate-pro:v1.0.0

Example 3: Deploy to Kubernetes

# Create namespace
kubectl create namespace flowstate

# Deploy application
kubectl apply -f k8s/deployment.yaml -n flowstate
kubectl apply -f k8s/service.yaml -n flowstate

# Check status
kubectl get pods -n flowstate
kubectl logs -f deployment/flowstate-pro -n flowstate

🧪 Testing

Run Tests

# Run all tests with coverage
npm test

# Run tests in watch mode
npm run test:watch

# Run specific test file
npm test -- tests/api.test.js

# Run only unit tests
npm test -- --testPathPattern=unit

# Generate coverage report
npm run test:coverage

Test Structure

tests/
├── unit/              # Component and function tests
├── integration/       # API and service tests
└── e2e/              # End-to-end tests

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for details on:

Code style guidelines
Testing requirements
Pull request process
Commit message conventions
Development setup

Quick Start for Contributors

# 1. Fork the repository
git clone https://github.com/yourusername/Uriesmooth-.git
cd Uriesmooth-

# 2. Create a feature branch
git checkout -b feature/amazing-feature

# 3. Make changes and commit
git add .
git commit -m "feat: Add amazing feature"

# 4. Push and create PR
git push origin feature/amazing-feature

🐛 Bug Reports & Feature Requests

🐛 Found a bug? Create an Issue
✨ Have an idea? Request a Feature

📋 Roadmap

Q3 2024

Advanced analytics dashboard
ML-powered optimization suggestions
Custom node marketplace

Q4 2024

Mobile app for iOS/Android
Enterprise SSO integration
Advanced audit logging

2025

Real-time collaboration v2
AI assistant for pipeline building
Advanced workflow templates

View Full Roadmap →

📞 Support

📖 Documentation: docs/
💬 Community Chat: GitHub Discussions
🐛 Issues: GitHub Issues
📧 Email: support@flowstatepro.io
🐦 Twitter: @flowstatepro

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with ❤️ for teams that ship fast
Inspired by modern workflow automation platforms
Thanks to all contributors
Special thanks to the open-source community

📊 Project Stats

Security & Privacy

🔒 Security Policy - Responsible disclosure
📋 Privacy Policy - Data handling
🛡️ Compliance - GDPR, SOC 2, ISO 27001

Made with 🚀 by Uriesmooth

⬆ Back to top

Name		Name	Last commit message	Last commit date
.github		.github
LICENSE		LICENSE
README.md		README.md

Uh oh!

Latest commit

History

Folders and files

Repository files navigation