Roflow

First Launch

Welcome to Roflow! This guide will help you set up your environment and get started with your first project.

Initial Setup

When you first launch Roflow, you'll see a welcome screen with several options:

1. Sign In or Create Account

To sign in:

  1. Click Sign In on the welcome screen
  2. Enter your email and password
  3. Or use OAuth (Google, GitHub)

To create an account:

  1. Click Create Account
  2. Enter your email and choose a password
  3. Verify your email address
  4. Select your plan (Free or Pro)

2. Choose Your First Action

After signing in, you'll see three options:

  • New Project - Start a fresh Roblox project
  • Import Game - Sync an existing Roblox game
  • Open Folder - Open an existing Rojo project

Creating Your First Project

Option 1: New Project

  1. Click New Project
  2. Choose a template:
    • Blank - Empty project
    • Baseplate - Simple baseplate
    • Game Template - Pre-configured game template
  3. Select a location to save your project
  4. Click Create

Roflow will:

  • Initialize a new Rojo project
  • Set up the project structure
  • Create a default.project.json file
  • Open the project in the editor

Option 2: Import Existing Game

If you have games on Roblox that you want to work on:

  1. Click Import Game
  2. Sign in to Roblox (if not already)
  3. Select a game from your list
  4. Choose where to save the project locally
  5. Click Import

Option 3: Open Existing Rojo Project

If you already have a Rojo project:

  1. Click Open Folder
  2. Navigate to your project directory
  3. Select the folder containing default.project.json
  4. Click Open

Exploring the Interface

Main Areas

1. Editor (Center)

  • Where you write your code
  • Supports Luau syntax highlighting
  • Inline completions and diagnostics

2. File Explorer (Left)

  • Browse your project files
  • Create/delete/rename files
  • Drag and drop to organize

3. AI Chat Panel (Right)

  • Ask questions and get help
  • Generate code snippets
  • Debug errors

4. Terminal (Bottom)

  • Run commands
  • View output from Rojo and other tools
  • Integrated terminal access

Key UI Elements

  • Status Bar (Bottom) - Shows LSP status, line/column, git branch
  • Activity Bar (Far Left) - Switch between Explorer, Search, Git, Extensions
  • Command Palette (Cmd/Ctrl + Shift + P) - Access all commands

Configuring Roflow

Essential Settings

Open Settings with Cmd/Ctrl + , and configure:

AI Settings:

  • AI Model - Choose between different models (Pro only)
  • Completion Style - Inline vs suggestions
  • Context Length - How much code to include

Editor Settings:

  • Theme - Choose dark or light theme
  • Font Size - Adjust editor font
  • Tab Size - Set indentation (recommended: 4 for Luau)

Luau Settings:

  • LSP Enabled - Keep this on for completions
  • Diagnostics - Enable linting and error checking
  • Format on Save - Auto-format code when saving

Install these extensions for the best experience:

  1. Selene - Luau linting
  2. Rojo Tools - Enhanced Rojo integration
  3. Color Picker - Visual color selection

Testing Your Setup

1. Create a Test File

  1. Right-click in the Explorer
  2. Select New File
  3. Name it test.lua
  4. Add this code:
print("Hello from Roflow!")

local part = Instance.new("Part")
part.Size = Vector3.new(4, 1, 2)
part.Position = Vector3.new(0, 10, 0)
part.BrickColor = BrickColor.new("Bright red")
part.Parent = workspace

2. Start Rojo Server

  1. Open the terminal (Cmd/Ctrl + ~)
  2. Run: rojo serve
  3. Connect from Roblox Studio using the Rojo plugin

3. Test AI Features

  1. Open the AI chat panel (Cmd/Ctrl + Shift + L)
  2. Type: "Explain what this code does"
  3. The AI should analyze your test.lua file

Common First-Launch Issues

Issue: AI Chat Not Responding

Solution:

  1. Check your internet connection
  2. Verify you're signed in
  3. Check the status bar for connection status
  4. Try restarting Roflow

Issue: Luau LSP Not Working

Solution:

  1. Make sure the file is saved with .lua extension
  2. Check status bar for LSP status (should show "Luau")
  3. Restart LSP: Cmd/Ctrl + Shift + P → "Restart Language Server"

Issue: Rojo Server Won't Start

Solution:

  1. Make sure Rojo is installed: rojo --version
  2. Check for a valid default.project.json file
  3. Try running rojo serve in the terminal manually

Next Steps

Now that you're set up, learn about:

PreviousInstallation
NextConfiguration