sucks.

The reluctant manual

Chapters / Getting some work done

Getting some work done

The least documented step is opening the project.

Choose your tools

Neovim is the default editor. Other editors are available through the menu. Use whichever one makes you productive; there is no entrance exam.

An editor is allowed to be familiar. You do not have to replace your working habits all at once to earn the benefits of a different desktop. Start with a project you understand and the tools you trust. You can investigate the intriguing terminal editor later, ideally before a deadline rather than during one.

A page that works is a better milestone than a terminal that looks busy.

Install your stack

Omarchy offers development environments including Laravel, Ruby on Rails, and Node.js. Mise manages language versions so your projects can use the versions they need. Follow the official manual for the current setup steps.

The menu saves you some setup work; it does not decide your application’s architecture or keep every dependency compatible forever. Check the requirements of your project, use its lockfiles, and follow its own setup notes. A well-prepared desktop is a useful beginning, not a promise that every repository on the internet has become reasonable.

Stop configuring, briefly

You can always return to the theme menu later. For now, run the app, fix the thing, or write the first paragraph. We regret to report that this part is still your responsibility.

The first meaningful improvement to a side project is often embarrassingly small. A page loads. A form saves. A bug stops happening. These events are less visually impressive than a wall of terminals, but they have the advantage of being the thing you originally meant to do. You may take a screenshot afterwards if it helps.

Ask for help without making it a referendum

If the setup goes wrong, describe what you ran, what you expected, and what happened. Relevant versions and the actual error are more useful than a speech about the state of software. Somebody may have seen the same issue already. Thank them if they help. Share the fix if you find it yourself. This is how a group of strangers accidentally becomes a community, and we are afraid it works rather well.

For actual instructions: read the official guide ↗