👋 Hello friend! Looks like you're reading this page on GitHub, which means some of the links may not work correctly. Please go to the rendered Foam Workspace for an improved experience!
👉 This is an early stage project under rapid development. For updates follow @jevakallio on Twitter.
Foam is a personal knowledge management and sharing system inspired by Roam Research, built on Visual Studio Code and GitHub.
You can use Foam for organising your research, keeping re-discoverable notes, writing long-form content and, optionally, publishing it to the web.
Foam is free, open source, and extremely extensible to suit your personal workflow. You own the information you create with Foam, and you’re free to share it, and collaborate on it with anyone you want.
Foam is a tool that supports creating relationships between thoughts and information to help you think better.
Whether you want to build a Second Brain or a Zettelkasten, write a book, or just get better at long-term learning, Foam can help you organise your thoughts if you follow these simple rules:
[[wiki-links]]
, and navigate between them to explore your knowledge graph.Foam is a like a bathtub: What you get out of it depends on what you put into it.
Like the soapy suds it’s named after, Foam is mostly air.
Fun fact: This documentation was researched, written and published using Foam.
⚠️ Foam is still in preview. Expect the experience to be a little rough.
These instructions assume you have a GitHub account, and you have Visual Studio Code installed.
After setting up the repository, open .vscode/settings.json and edit, add or remove any settings you’d like for your Foam workspace.
To learn more about how to use Foam, read the [recipes].
There are [known-issues], and I’m sure, many unknown issues! Please report them on GitHub!
Foam doesn’t have features in the traditional sense. Out of the box, you have access to all features of VS Code and all the [recommended-extensions] you choose to install, but it’s up to you to discover what you can do with it!
Head over to [recipes] for some useful patterns and ideas!
The goal of Foam is to be your personal companion on your quest for knowledge.
It’s is currently about “10% ready” relative to all the features I’ve thought of, but I’ve only thought of ~1% of the features it could have, and I’m excited to learn from others.
I am using it as my personal thinking tool. By making it public, I hope to learn from others not only how to improve Foam, but also to improve how I learn and manage information.
If that sounds like something you’re interested in, I’d love to have you along on the journey.
Foam is built by Jani Eväkallio (@jevakallio).
Foam was inspired by Roam Research and the Zettelkasten methodology
Foam wouldn’t be possible without Visual Studio Code and GitHub, and relies heavily on our fantastic open source [recommended-extensions] and all their contributors:
Foam is licensed under the MIT license.