@enhance-eng/archangel 0.0.1 → 0.1.1

package/README.md

@@ -1,5 +1,29 @@
-# @enhance-eng/archangel
+# Archangel
 
-Placeholder, see the first release of [Archangel](https://github.com/enhance-labs-builds/archangel).
+**Make architecture verifiable.**
 
-This initial package enables trusted publishing. It does not contain the linter yet.
+![Seconds to check the same 400 architecture rules on a 9,800-file TypeScript monorepo: archangel 1.9 s; dependency-cruiser, ESLint and Steiger together 67.7 s](https://raw.githubusercontent.com/enhance-labs-builds/archangel/main/docs/assets/speed-light.svg)
+
+Architecture tests for TypeScript, checked in milliseconds. You write down how your code is
+organized. Archangel tells you when the code breaks those rules, and what to do about it. It checks
+a large repository in about a second, so it can run in your editor as you type.
+
+```sh
+npm install --save-dev @enhance-eng/archangel
+npx archangel init --typescript
+npx archangel check
+```
+
+Archangel checks imports, import cycles, file and folder names, the files that folders must contain,
+and exports. It has presets for Feature-Sliced Design and Next.js, and you can write your own
+conditions in TypeScript.
+
+- [Quick start](https://github.com/enhance-labs-builds/archangel/blob/main/README.md#quick-start)
+- [Rules](https://github.com/enhance-labs-builds/archangel/blob/main/docs/rules.md)
+- [Presets](https://github.com/enhance-labs-builds/archangel/blob/main/docs/presets.md)
+- [Plugins](https://github.com/enhance-labs-builds/archangel/blob/main/docs/plugins.md)
+- [Commands](https://github.com/enhance-labs-builds/archangel/blob/main/docs/commands.md)
+
+The package includes a prebuilt binary for macOS, Linux and Windows. You do not need Rust.
+
+Licensed under MIT or Apache-2.0, at your option.