FlowKit

Free n8n workflow templates. Copy, paste, automate.

Generate Convert Improve

Install / Use

npx skills add harshit-exe/FlowKit

Installs into whichever agent you are using.

About this skill

Quality Score

0/100

README

FlowKit 🚀

The Ultimate n8n Workflow Library Platform

Discover, share, and deploy 150+ curated n8n automation workflows. <br/> Built with ❤️ in India 🇮🇳

Live Demo · Documentation · Report Bug · Request Feature

</div>

⭐ Star History

✨ Features

🔍 For Users

150+ Curated Workflows - Hand-picked and tested
AI Workflow Builder - Generate workflows with Gemini AI
Advanced Search & Filters - Find exactly what you need
Instant Copy/Download - Get workflows in one click
Community Features - Comments, votes, and saves

</td> <td>

⚡ For Developers

Modern Stack - Next.js 14, TypeScript, Prisma
Production Ready - Secure, scalable, optimized
Admin Panel - Full CRUD operations
API Routes - RESTful endpoints included
Open Source - MIT licensed, contribute freely

</td> </tr> </table>

🚀 Quick Start

Get FlowKit running locally in under 5 minutes!

Prerequisites

Node.js 18.x or higher (Download)
MySQL 8.x or compatible database provider
npm or yarn package manager

Installation

Clone the repository

git clone https://github.com/harshit-exe/FlowKit.git
cd FlowKit

Install dependencies
```
npm install
```
Set up environment variables
```
cp .env.example .env
```
Edit .env and configure your database and API keys (see Environment Variables below)

Set up the database

# Generate Prisma client
npx prisma generate

# Push schema to database
npx prisma db push

# Seed with sample data (super admin + workflows)
npx prisma db seed

Start the development server
```
npm run dev
```
Open your browser 🎉
- Public site: http://localhost:3000
- Admin panel: http://localhost:3000/admin
Default Admin Credentials:
- Email: admin@flowkit.in
- Password: Admin@123!
⚠️ Change these credentials immediately after first login!

📋 Environment Variables

Create a .env file in the root directory with the following variables:

| Variable | Required | Description | Example | |----------|----------|-------------|---------| | DATABASE_URL | ✅ Yes | MySQL connection string | mysql://user:pass@host:3306/flowkit | | NEXTAUTH_URL | ✅ Yes | Your app's base URL | http://localhost:3000 | | NEXTAUTH_SECRET | ✅ Yes | Secret for JWT encryption | Generate with openssl rand -base64 32 | | GEMINI_API_KEY | ✅ Yes | Google Gemini API key | Get from Google AI Studio | | RESEND_API_KEY | ✅ Yes | Email service API key | Get from Resend | | NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME | ✅ Yes | Cloudinary cloud name | From Cloudinary Console | | CLOUDINARY_API_KEY | ✅ Yes | Cloudinary API key | From Cloudinary Console | | CLOUDINARY_API_SECRET | ✅ Yes | Cloudinary API secret | From Cloudinary Console | | GROQ_API_KEY | ⚠️ Optional | Groq AI for thumbnails | Get from Groq Console | | NEXT_PUBLIC_CLARITY_PROJECT_ID | ⚠️ Optional | Microsoft Clarity analytics | From Clarity | | NEXT_PUBLIC_ENABLE_ACCESS_GATE | ⚠️ Optional | Enable waitlist feature | true or false (default: false) |

💡 Tip: Check .env.example for detailed descriptions and instructions for each variable.

🗄️ Database Setup

FlowKit supports any MySQL-compatible database. Here are some recommended providers:

Option 1: Local MySQL

# Install MySQL locally
brew install mysql  # macOS
# or download from https://dev.mysql.com/downloads/

# Create database
mysql -u root -p
CREATE DATABASE flowkit;

Option 2: Cloud Providers (Recommended for Production)

Aiven - Free tier available, excellent performance
PlanetScale - Serverless MySQL, generous free tier
Railway - Easy setup, good for development

SSL/TLS Connection

If your database requires SSL, append to your DATABASE_URL:

?sslaccept=strict

Database Commands

# Generate Prisma Client (after schema changes)
npx prisma generate

# Push schema changes to database (development)
npx prisma db push

# Run migrations (production)
npx prisma migrate deploy

# Seed database with sample data
npx prisma db seed

# Open Prisma Studio (visual database editor)
npx prisma studio

📁 Project Structure

flowkit/
├── prisma/
│   ├── schema.prisma          # Database schema
│   └── seed.ts                # Database seeding script
├── src/
│   ├── app/
│   │   ├── (public)/          # Public-facing pages
│   │   │   ├── page.tsx       # Homepage
│   │   │   ├── workflows/     # Workflow listings & details
│   │   │   └── ai-builder/    # AI workflow generator
│   │   ├── admin/             # Admin panel
│   │   │   ├── dashboard/     # Admin dashboard
│   │   │   ├── workflows/     # Workflow management
│   │   │   └── categories/    # Category management
│   │   └── api/               # API routes
│   │       ├── workflows/     # Workflow CRUD APIs
│   │       ├── search/        # Search API
│   │       └── ai/            # AI generation API
│   ├── components/
│   │   ├── admin/             # Admin-specific components
│   │   ├── layout/            # Layout components (navbar, footer)
│   │   ├── workflow/          # Workflow display components
│   │   └── ui/                # shadcn/ui components
│   ├── lib/
│   │   ├── prisma.ts          # Prisma client instance
│   │   ├── auth.ts            # NextAuth configuration
│   │   ├── gemini.ts          # Google Gemini AI client
│   │   └── utils.ts           # Utility functions
│   └── types/                 # TypeScript type definitions
├── public/
│   ├── thumbnails/            # Workflow thumbnail images
│   └── assets/                # Static assets
└── package.json

🌐 API Endpoints

FlowKit provides a RESTful API for managing workflows:

Workflows

GET /api/workflows - List all workflows (with pagination & filters)
POST /api/workflows - Create a new workflow
GET /api/workflows/[id] - Get workflow by ID
PUT /api/workflows/[id] - Update workflow
DELETE /api/workflows/[id] - Delete workflow
GET /api/workflows/[id]/stats - Get workflow statistics

Search & Discovery

GET /api/search - Search workflows by keywords, tags, categories
GET /api/categories - List all categories
GET /api/tags - List all tags

AI Generation

POST /api/ai/generate - Generate workflow using AI (Gemini)

Community

POST /api/workflows/[id]/vote - Upvote/downvote workflow
POST /api/workflows/[id]/save - Save workflow to collection
GET /api/workflows/[id]/comments - Get workflow comments

📖 For detailed API documentation, visit our API Reference.

🚢 Deployment

Deploy to Vercel (Recommended)

Push to GitHub
```
git push origin main
```
Import to Vercel
- Go to vercel.com
- Click "New Project"
- Import your GitHub repository
- Vercel will auto-detect Next.js
Configure Environment Variables
- Add all variables from your .env file
- Update NEXTAUTH_URL to your production domain
Deploy
- Click "Deploy"
- Your app will be live in ~2 minutes!