Setup

Text Forge currently supports Linux and Windows (You can use it on other platforms with build it from source), Just download latest and extract it where your want!

Now you can run Text Forge with Text Forge runnable file:

Install Modes

Now, you have a very lightweight editor, it's more like a core. There is a lot of plugged modules like action scripts, panels, etc. but you need another type of module too for work with you editor. This type is Mode, you can find more about modes here, but for now let's get your modes from Text Forge Marketplace!

You can use Settings > Marketplace to find themes, extensions, and modes and install them in one click. For modes, use filter option in top-right corner of marketplace window and set it from All to Modes. Now you can see available modes, click on a mode to see it's details, if it's what you want click on Install button and wait until Package Installed! notification.

Open A File

You have a ready code editor! Let's open a file:

• In top left of editor you have a list of menus. Click on File menu in top left.
• Click on Open and select your file in opened file dialog.
• Based on your file type (extension), Text Forge will open it in one of these ways:
  1. You have one installed mode for this file: Here, Text Forge will use mode to load file in editor and loads syntax highlighter from mode.
  2. You have some installed mode for this file: A popup will show, and you can select a mode to open file, then we have first situation.
  3. You haven't any installed mode for this file: Text Forge will send a warning (You can see it in notification panel) and open file using UTF-8 encoding. With this behavior you can open any file type that encoded with UTF-8 without any mode (It means a lot of files!) but there is no syntax highlighter for these files.
• Well done!

Create New Project

If you've used other editors, you'll notice a different project concept. In other editors:

• A project is a folder.
• Project information is stored in a subfolder of that folder (e.g., .textforge).

In Text Forge:

• A project is a .tfproj file.
• Project information is stored in that file.

But why? We have specific reasons for this design:

Feature	Folder-based projects	.tfproj projects
File Path Flexibility	Only files inside the folder	Any file from any path
Single-File Projects	Requires a folder	A single file is enough
Custom Project Settings	Scattered across multiple files	Centralized in .tfproj

Overall, this design gives you more flexibility. You can keep parts of a larger project in different folders and switch between them in the editor with a single click.

Let's see Text Forge projects in action. You can create a project from Project > New Project. This opens the New Project window with these fields:

• Project File — Path to your .tfproj file.
• Name — Project name.
• Details — Optional project details.
• Icon — Optional project icon.
• Tags — Optional comma-separated list of tags.
• Include — Folders and files to add to the project.
• Exclude — Folders and files to exclude from the project.

When you press the Create button, the editor creates the project, and you can use Project > Open Project to open it. Then, navigate between project files in the Files panel on the left side of the editor. To automatically save files when moving between project files, enable Settings > Preferences... > Files > Save Files When Moving Between Project Files.