Create highly performant web apps with SSR, branching, version control, components, and much more! Visit nordcraft.com to learn more.
Discord | BlueSky | YouTube | LinkedIn | X
This repository holds different packages that are used internally by the Nordcraft framework. The packages that are currently available are:
- core 👈 holds core (shared) logic used by the other packages
- runtime 👈 includes logic for hydrating/running/updating a Nordcraft application on the front-end
- ssr 👈 holds part of the server-side rendering logic
- lib 👈 holds all builtin formulas and actions used by the runtime and during ssr
- search 👈 holds all issue rules and search functionality for traversing a Nordcraft project. This powers the issue panel in the Nordcraft editor in a web worker atm
Install using bun by running bun install
- Install:
bun install - Lint:
bun lint - Check types:
bun typecheck - Build:
bun run build<-- builds all packages
While we consume all packages internally in the Nordcraft framework, this project is currently in development and is not yet ready for other applications to consume.
As announced in July '24, Nordcraft is in the process of going fully open source. The goal is to move more and more code into this repository and make it possible to self host a Nordcraft application.
We're currently working on moving more of the server-side rendering logic into this repository. This means that most updates are going to be in the ssr package for the time being.
The dependencies between the packages are as follows:
coreis a dependency for all other packagesssris a dependency forsearchstd-libis a dependency forruntimeandssr
We use GitHub releases and release to npm atm, which is where we consume packages from internally.
To release a new version to npm:
- Update the version in the root
package.jsonfile - Create a PR
- Once the PR is merged, it will automatically release all packages to npm
If you find a bug or have an idea for a new feature, please open an issue. We also welcome pull requests. We are actively monitoring this repository.
If you have any questions, feel free to ask them in our Discord or reach out by e-mail
To consume all packages locally, it's useful to run bun run link in the root of the repository. This will use bun link on all packages in the repository.
Other than that, the best way to test atm is to use the hono example.
The Nordcraft docs are open source.
If you'd like to contribute to the documentation, view all open issues on GitHub, or open an issue if you find something wrong or missing.