QTCC

The compiler behind Quart.

QTCC is the native compiler and toolchain for Quart. It is designed to make systems programming feel direct without making developers manually manage the machinery underneath.

Write Quart. Let QTCC handle the rest.

Quart source
     ↓
   QTCC
     ↓
 QTIR / QTUA
     ↓
 native machine code
     ↓
 FASM / object files
     ↓
    LLD
     ↓
 executable / DLL

Enter fullscreen mode Exit fullscreen mode

Why QTCC?

Native development shouldn’t require developers to become experts in their platform’s entire build ecosystem.

QTCC’s job is to understand the program and the target, then automatically handle the complicated parts of compilation and linking.

Instead of manually configuring:

• compilers
• assemblers
• linkers
• library paths
• object files
• platform-specific options
• DLL/shared-library configuration
• target-specific build settings

QTCC aims to make the toolchain itself responsible for those decisions.

quart build

Enter fullscreen mode Exit fullscreen mode

That’s the goal.

Built for Quart

QTCC is not a generic compiler frontend. It is being designed alongside the Quart language and its execution model.

Quart gives developers high-level abstractions when they want them while still allowing direct access to memory and platform functionality when they need it.

For example:

const a = 78
let b = 89

let ptr = @rawLoc(a)
let num = *ptr

Enter fullscreen mode Exit fullscreen mode

Or when you need to go all the way down to a platform API:

extern proc[WriteFile]:
    [win32x64=WriteFile]:(usize, length, usize)

Enter fullscreen mode Exit fullscreen mode

QTCC’s responsibility is to make both levels work within the same toolchain.

Cross-platform by design

QTCC is being built around the idea that cross-platform development should not mean manually maintaining a pile of platform-specific build configurations.

The compiler knows the target.

The compiler knows the architecture.

The compiler knows what the program requires.

It should therefore be able to select and configure the appropriate native toolchain automatically.

The long-term target is:

Windows
Linux
Android
Web

Enter fullscreen mode Exit fullscreen mode

with platform-specific machinery hidden behind the Quart toolchain wherever possible.

No build configuration maze

A new Quart project should not begin with a wall of configuration files.

The intended experience is closer to:

my-project/
├── src/
└── libs/

Enter fullscreen mode Exit fullscreen mode

Then:

quart init .
quart build

Enter fullscreen mode Exit fullscreen mode

QTCC determines what is required and coordinates the compilation pipeline.

The goal isn’t to remove control.

The goal is to make control available when you want it instead of forcing it on you when you don’t.

Low-level when you need it

QTCC doesn’t try to prevent developers from reaching the machine.

Quart can work directly with:

• pointers
• raw memory
• external procedures
• native libraries
• platform APIs
• assembly
• object files

You can stay productive at the language level, or drop down into the machinery when your application actually requires it.

That makes QTCC suitable for the same kind of software where you’d normally reach for a systems language.

The native toolchain

QTCC is designed to work with existing low-level tooling rather than reinventing every piece of the native toolchain.

For example:

QTCC
  │
  ├── FASM
  │     └── assembly → object code
  │
  └── LLD
        └── object files → final binary

Enter fullscreen mode Exit fullscreen mode

This allows QTCC to focus on what it actually needs to own:

understanding Quart and producing the correct native program.

Compiler architecture

QTCC is being developed around several compiler stages, including:

Tokenizer
   ↓
Parser
   ↓
AST
   ↓
Lowering
   ↓
QTIR
   ↓
QTUA / backend
   ↓
Object generation
   ↓
Linking

Enter fullscreen mode Exit fullscreen mode

The architecture is intentionally being developed so that platform-specific code generation does not leak throughout the entire compiler.

Designed to grow

QTCC is not intended to stop at producing simple executables.

The toolchain is being built toward:

• native executables
• object files
• DLLs/shared libraries
• cross-platform compilation
• platform APIs through extern
• optimized release builds
• debugging support
• Quart’s standard library
• future self-hosting

Eventually, QTCC itself can become a Quart program.

QTCC
  ↓
compiles Quart
  ↓
Quart implementation of QTCC
  ↓
QTCC compiles itself

Enter fullscreen mode Exit fullscreen mode

Status

🚧 QTCC is actively under development.

The compiler is currently being developed alongside Quart, and major pieces of the native pipeline are still evolving.

Current work includes:

• [x] Core language compilation
• [ ] if / else
• [ ] Pointer operations
• [ ] extern
• [ ] Object generation
• [ ] DLL generation
• [ ] .obj generation
• [ ] Cross-platform toolchain
• [ ] Standard library
• [ ] Self-hosting

The architecture will continue to change as Quart matures.

The philosophy

QTCC follows a simple idea:

The compiler should handle the machinery so the developer can focus on the program.

You shouldn’t need to understand five different build systems to compile a 200-line application.

You shouldn’t need to manually hunt down incompatible dependencies.

You shouldn’t need to configure machinery you didn’t create just because you wanted to use it.

But when you do need the machinery, Quart should let you reach it.

That’s QTCC.

Part of the Quart ecosystem

QTCC is one component of the larger Quart ecosystem.

                QUART
                  │
        ┌─────────┼─────────┐
        │         │         │
       QTCC      Yaki      QBot
     Compiler   Renderer   Assistant

Enter fullscreen mode Exit fullscreen mode

• Quart — the programming language
• QTCC — the compiler and native toolchain
• Yaki — graphics and rendering infrastructure
• QBot — the development assistant

The goal is a complete development environment where the language, compiler, tooling and runtime are designed to work together.

Contributing

QTCC is being developed as an open project.

Compiler development, language design, backend work, optimization, tooling, documentation and testing are all welcome areas for contribution.

If you’re interested in compilers, systems programming, language design or native toolchains, you’re welcome here.

QTCC is being built from the ground up.

GitHub Link:
https://github.com/joshuaogunlade903-cpu/QTCC.git