https://github.com/topheman/toolchain-notes

Notes taken while diving in the source code of rolldown/oxc/vite ...
https://github.com/topheman/toolchain-notes

oxc rolldown rollup rust vite

Last synced: 9 days ago
JSON representation

Notes taken while diving in the source code of rolldown/oxc/vite ...

• Host: GitHub
• URL: https://github.com/topheman/toolchain-notes
• Owner: topheman
• License: cc-by-sa-4.0
• Created: 2024-10-23T12:15:25.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2024-10-24T22:47:47.000Z (2 months ago)
• Last Synced: 2024-10-25T13:58:55.526Z (2 months ago)
• Topics: oxc, rolldown, rollup, rust, vite
• Language: Markdown
• Homepage: https://topheman.github.io/toolchain-notes/
• Size: 27.3 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-CC-BY-SA

Awesome Lists containing this project

README

        
# Toolchain Notes

*by Christophe Rosset*

My original goal was to better understand the internals of the oxc ecosystem, which as of this day may well be on track to be the new standard for JavaScript tooling.

This involves subjects that I really enjoy, some of them I know well, some others I wish to get better at. This repository contains the notes I've taken while diving into the source code of [rolldown](https://github.com/rolldown/rolldown), [oxc](https://github.com/oxc-project/oxc) and its ecosystem.

The goal isn't to explain each line of code (they will eventually evolve over time), but to understand how the blocks fit together and how the technologies are used.

If you read this book, you will:

- Get into the internals of [rolldown](./rolldown/README.md), [oxc](./oxc/README.md) (the oxc part is still wip)

- Discover how technologies such as Wasm and Napi are used inside those projects

Disclaimer: This work is based on myself reading the source code over multiple repositories.

- I might get some things wrong

- Some of my findings may end up out of date somehow

An html version is available at 

[You can also read the book directly on github](./src/SUMMARY.md).

## Contributing

I wrote something incorrect ? You can make a contribution and fix it.

Click on the link on top right of the book, this will prompt you to fork the project and you will be able to make the modification directly in the github UI.

You can also propose a PR by hand.

## Generating the html version with mdbook

The html version can be generated with [`cargo-mdbook`](https://crates.io/crates/mdbook).

### Install

```sh

cargo install mdbook

```

### Generate

```sh

mdbook build .

# generated in ./book

```

### Watch mode

```sh

mdbook watch -o .

```