Skip to content

focus-editor/focus

Repository files navigation

Focus

A simple editor whose goal is to get out of your way and let you do work.

This editor is for people who value simplicity, are sensitive to input latency and do not require heavy language support in their editor.

focus-0 3 0

Quick start

  1. Download the executable and put it somewhere where it will live.

  2. Launch the executable. Once launched, it will generate its configuration files.

    • On Windows, it will create a global.focus-config file and a projects folder next to itself.
    • On macOS, these files will be found in /Users/YOURNAME/Library/Application Support/dev.focus-editor/.
    • On Linux, these files will be found in ${XDG_CONFIG_HOME}/focus-editor/ (which usually expands to ${HOME}/.config/focus-editor).
  3. Open the global config file by using the command Open Global Config - you can find the shortcut to show commands on the welcome screen.

  4. This editor expects that you tell it what folders it should add to the workspace. You do it by either editing the global config file for your default workspace, or by creating a project (see below)

  5. A project in this editor is just a config file that lives in projects/Project Name.focus-config. There's an example project config file provided. You just edit the file and then activate the project by using the Switch To Project command.

NOTE: if you are on a newer macOS you may have to run xattr -d com.apple.quarantine /Applications/Focus.app in order to be able to run the editor, until we are able to sign the executable.

Official Discord server

https://discord.gg/eSXquAzTmW

How to compile

$ jai first.jai - release

(NOTE: it's - release, not -release)

Minimum Jai version: 0.1.096 (the language is currently in closed beta, but it will hopefully go into open beta soon)

On macOS:

  1. Full XCode must be installed

  2. To avoid multiple security warnings like in these screenshots:

"freetype.dylib" cannot be opened because the developer cannot be verified. macOS cannot verify that this app is free from malware.

... run the following command:

xattr -d -r com.apple.quarantine /path/to/your/jai/distribution

NOTE: starting with Jai 0.1.090, AArch64 became the default platform when building on Apple Sillicon macs. However, some of the modules used by the editor are not fully ported to support it. You will need to use the x86_64 compiler to build for macOS (for now):

arch -x86_64 /path/to/jai-macos first.jai - release

Disclaimer

The editor is in beta. This means you may encounter some bugs here and there, and not all wrinkles have been ironed out yet.

Limitations

  • Only 64-bit systems are supported, Windows 8+, Linux (WIP), macOS (WIP).
  • This editor is not designed for editing very large files (it is expected that editing might start lagging upwards of 100K LOC). 2GB files is a hard limit right now.
  • CRLF will be converted to LF on save. It's time to move on.
  • Multi-codepoint Unicode symbols are not supported.
  • Currently only RGB monitor panels are supported. If your text looks funny or blurry, please open an issue.

Acknowledgements

  • The editor was made possible by the fantastic Jai programming language by Jonathan Blow.

  • The editor was inspired by Jamie Brandon's blog post. Nothing other than the name was borrowed from his editor - the name was just too good.

  • I am very grateful to my wife who supported me along the way and took on the bigger share of the housework to let me work on the editor.

  • A special thanks to the two early adopters who helped to make the editor more robust and more enjoyable to use: @cookednick and @ustance.

  • The default font FiraCode is created by Nikita Prokopov.

  • Icons - Font Awesome by Dave Gandy.

  • If not for VSCode's annoying "restart to apply the latest update" notifications every other day, this editor might never have been created.