Installation

Get FlowCraft up and running on your system in just a few steps.

System Requirements

Minimum Requirements

• OS: Windows 10, macOS 10.14, or Ubuntu 18.04+

• RAM: 4GB (8GB recommended)

• Storage: 2GB free space

• Browser: Chrome 90+, Firefox 88+, Safari 14+, or Edge 90+

Recommended Requirements

• OS: Latest version of Windows, macOS, or Linux

• RAM: 8GB or more

• Storage: 5GB free space

• Internet: Stable broadband connection

Installation Options

Option 1: Web Application (Recommended)

The easiest way to get started is through our web application:

1. Visit https://app.flowcraft.dev

2. Sign up for a free account

3. Complete the onboarding process

4. Start creating your first project!

Option 2: Desktop Application

For enhanced performance and offline capabilities:

Windows

# Download the installer
curl -O https://releases.flowcraft.dev/windows/flowcraft-setup.exe

# Run the installer
./flowcraft-setup.exe

macOS

# Using Homebrew
brew install flowcraft

# Or download directly
curl -O https://releases.flowcraft.dev/macos/flowcraft.dmg

Linux

# Ubuntu/Debian
wget https://releases.flowcraft.dev/linux/flowcraft.deb
sudo dpkg -i flowcraft.deb

# CentOS/RHEL/Fedora
wget https://releases.flowcraft.dev/linux/flowcraft.rpm
sudo rpm -i flowcraft.rpm

Option 3: CLI Tool

For developers who prefer command-line interfaces:

# Install via npm
npm install -g @flowcraft/cli

# Verify installation
flowcraft --version

# Login to your account
flowcraft login

Post-Installation Setup

1. Account Setup

After installation, create your FlowCraft account:

1. Open FlowCraft

2. Click "Sign Up" or visit the web app

3. Enter your email and create a password

4. Verify your email address

5. Complete your profile

2. Initial Configuration

Configure FlowCraft for your workflow:

# Set your preferred framework
flowcraft config set framework react

# Set default styling
flowcraft config set styling tailwind

# Configure output directory
flowcraft config set output ./src/components

3. Integration Setup

Connect your design tools:

Figma Integration

1. Go to Settings > Integrations

2. Click "Connect Figma"

3. Authorize FlowCraft in Figma

4. Select your teams and projects

Git Integration

# Connect your Git repository
flowcraft git connect https://github.com/your-username/your-repo

# Set up automatic commits
flowcraft config set git.auto-commit true

Verification

Verify your installation is working correctly:

Web Application

1. Log into your FlowCraft dashboard

2. Create a new project

3. Upload a sample design file

4. Generate your first component

Desktop/CLI

# Check system status
flowcraft status

# Run a test generation
flowcraft generate --test

# View available commands
flowcraft help

Troubleshooting

Common Issues

Installation fails on Windows

• Ensure you have administrator privileges

• Disable antivirus temporarily during installation

• Check Windows version compatibility

macOS security warnings

• Right-click the app and select "Open"

• Go to System Preferences > Security & Privacy

• Click "Open Anyway" for FlowCraft

Linux permission errors

# Fix permissions
sudo chmod +x /usr/local/bin/flowcraft

# Install dependencies
sudo apt-get install -y nodejs npm python3

Browser compatibility issues

• Clear browser cache and cookies

• Disable browser extensions temporarily

• Update to the latest browser version

Getting Help

If you encounter issues:

1. Check our troubleshooting guide

2. Search our FAQ

3. Contact support

Next Steps

Now that FlowCraft is installed:

1. Follow our Quick Start guide

2. Create your first project

3. Learn basic concepts

Welcome to FlowCraft! 🎉