Docs/Getting Started/Introduction
Introduction
Welcome to the Fid documentation!
On this page
What is Fid?
Fid is a systems programming language built for safety you can check. It combines a borrow checker without lifetime annotations, capability grants on imports, effect tracking and handlers, and comptime metaprogramming. It compiles through C, or straight to native Windows and Linux executables with its own code generator: no LLVM.
Good to know: Fid source files use the
.fdextension. The compiler is called Fides (the command isfid); it is written in Fid (72 modules, about 210K lines) and builds itself to a byte-identical fixpoint. v0.8.0-unstable is on the releases page; stable is planned for December and all work is on the main branch. The rules of the language are in the language reference. Grab the Windows installer or see Installation.
Why "Fid"?
Fid is short for Fides, the Latin word for trust and good faith. In Roman mythology, Fides was the goddess of good faith and honor (her Greek counterpart is Pistis, πίστις), depicted sometimes as a draped woman and sometimes as two joined hands. That is a fitting emblem for a language whose whole design is about guarantees you can trust at compile time.
How to use these docs
The documentation is organized into four tiers, listed in the sidebar:
- Getting Started: installation and a first program.
- Language: the core of Fid, one concept per page, in reading order.
- Toolchain: the
fidCLI, backends, watch mode, and editor integration. - Reference: the standard library, the feature status matrix, and migration notes.
You can read linearly, since every page ends with Previous / Next links, or jump straight to what you need. Each page has an "On this page" outline on the right.
Pre-requisite knowledge
These docs assume basic familiarity with programming. Experience with Rust, Kotlin, Swift, or Zig helps, since Fid deliberately borrows their best ideas, but every concept is explained from first principles, and the v1.0 syntax uses keywords you already know: fn, val, var, const,return, type.
Join the community
Fid is built in the open. Ask questions and propose ideas in GitHub Discussions, report bugs in Issues, and follow progress on the changelog.