swc/README.md

94 lines
3.7 KiB
Markdown
Raw Normal View History

2019-02-02 15:42:46 +03:00
<p align="center">
<a href="https://swc.rs/">
2022-10-02 11:08:13 +03:00
<img alt="swc" src="https://raw.githubusercontent.com/swc-project/logo/master/swc.png" width="546">
2019-02-02 15:42:46 +03:00
</a>
</p>
2019-01-22 11:28:31 +03:00
<p align="center">
2022-10-02 11:08:13 +03:00
Make the web (development) faster.
2019-01-22 11:28:31 +03:00
</p>
2019-01-22 11:28:31 +03:00
<p align="center">
2022-10-02 11:08:13 +03:00
<a href="https://www.npmjs.com/package/@swc/core">
<img alt="npm Downloads" src="https://img.shields.io/npm/dm/@swc/helpers">
</a>
<a href="https://crates.io/crates/swc_ecma_parser">
<img alt="undefined" src="https://img.shields.io/crates/d/swc_ecma_parser.svg?label=crates.io%20downloads">
</a>
<a href="https://github.com/swc-project/swc/releases/latest">
2022-06-16 07:54:19 +03:00
<img alt="GitHub release (latest SemVer)" src="https://img.shields.io/github/v/release/swc-project/swc">
2022-10-02 11:08:13 +03:00
</a>
2019-01-22 11:28:31 +03:00
</p>
2022-06-16 07:54:19 +03:00
2019-01-22 11:28:31 +03:00
<p align="center">
2022-10-02 11:08:13 +03:00
<img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/swc-project/swc">
<a href="https://github.com/swc-project/swc/blob/main/package.json#L22">
<img alt="node-current (scoped)" src="https://img.shields.io/node/v/@swc/core">
</a>
2022-06-16 07:54:19 +03:00
</p>
<p align="center">
2022-10-02 11:08:13 +03:00
<a href="https://discord.com/invite/GnHbXTdZz6">
<img alt="Discord" src="https://img.shields.io/discord/889779439272075314">
</a>
2019-01-22 11:28:31 +03:00
</p>
SWC (stands for `Speedy Web Compiler`) is a super-fast TypeScript / JavaScript compiler written in Rust. It's a library for Rust and JavaScript at the same time. If you are using SWC from Rust, see [rustdoc](https://rustdoc.swc.rs/swc/) and for most users, your entry point for using the library will be [parser](https://rustdoc.swc.rs/swc_ecma_parser/).
2021-07-09 14:01:23 +03:00
Also, SWC tries to ensure that
> If you select the latest version of each crates, it will work
2022-09-14 13:33:49 +03:00
for rust users.
MSRV of crates named `swc_ecma_*` is the current stable, and nightly for others.
---
If you are using SWC from JavaScript, please refer to [docs on the website](https://swc.rs/docs/installation/).
# Documentation
Check out the documentation [in the website](https://swc.rs/docs/installation/).
# Features
2021-11-13 09:23:37 +03:00
Please see [comparison with babel](https://swc.rs/docs/migrating-from-babel).
# Performance
Please see [benchmark results](https://swc.rs/docs/benchmark-transform) on the website.
2019-01-22 11:28:31 +03:00
<h2 align="center">Supporting swc</h2>
<p align="center">
2022-10-02 11:08:13 +03:00
<a href="#backers">
<img alt="Backers on Open Collective" src="https://opencollective.com/swc/tiers/backer/badge.svg?label=backer&color=brightgreen" />
</a>
<a href="#gold-sponsors">
<img alt="Gold sponsors on Open Collective" src="https://opencollective.com/swc/tiers/gold-sponsors/badge.svg?label=Gold%20sponsors&color=brightgreen"/>
</a>
<a href="#silver-sponsors">
<img alt="Silver sponsors on Open Collective" src="https://opencollective.com/swc/tiers/silver-sponsors/badge.svg?label=Silver%20sponsors&color=brightgreen"/>
</a>
<a href="#bronze-sponsors">
<img alt="Bronze sponsors on Open Collective" src="https://opencollective.com/swc/tiers/bronze-sponsors/badge.svg?label=Bronze%20sponsors&color=brightgreen"/>
</a>
2019-01-22 11:28:31 +03:00
</p>
SWC is a community-driven project, and is maintained by a group of [volunteers](https://opencollective.com/swc#team). If you'd like to help support the future of the project, please consider:
2019-01-22 11:28:31 +03:00
2022-10-02 11:08:13 +03:00
- Giving developer time on the project. (Message us on [Discord](https://discord.gg/GnHbXTdZz6) (preferred) or [Github discussions](https://github.com/swc-project/swc/discussions) for guidance!)
- Giving funds by becoming a sponsor (see https://opencollective.com/swc)!
2019-02-13 12:25:19 +03:00
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). You may also find the architecture
documentation useful ([ARCHITECTURE.md](ARCHITECTURE.md)).
## License
2022-10-02 11:08:13 +03:00
SWC is primarily distributed under the terms of the Apache License (Version 2.0).
2022-10-02 11:08:13 +03:00
See [LICENSE](LICENSE) for details.