https://github.com/0-vortex/replit-node16-npm8-global-starter
bare install of node@16 and npm@8 with a global config set in home folder able to do global installs
https://github.com/0-vortex/replit-node16-npm8-global-starter
Last synced: 5 months ago
JSON representation
bare install of node@16 and npm@8 with a global config set in home folder able to do global installs
- Host: GitHub
- URL: https://github.com/0-vortex/replit-node16-npm8-global-starter
- Owner: 0-vortex
- Created: 2021-12-24T10:26:23.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-12-30T07:29:26.000Z (over 4 years ago)
- Last Synced: 2024-12-30T01:34:42.543Z (over 1 year ago)
- Language: Nix
- Size: 14.6 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Replit Nix Node@16 Npm@8 tutorial
[](https://repl.it/github/0-vortex/replit-node16-npm8-global-starter)
> Warning: Nix support on Replit is still under heavy development and is subject to change.
You've just created a new Nix repl. There's not much here yet but with a little work you can use it as the starting point for *ANYTHING*.
To get started there are 2 config files that you can use to customize the environment. To show them click the 3 dots menu button in the file tree and then click "Show config files".
### `shell.nix` - Configures the nix shell environment
This file should look something like the example below. The `deps` array is replaced by shell generation.
What we are doing here is getting a sandbox reload mechanism, `node@16` and a separate binary install of `npm@8` which we then configure to sensible userspace defaults:
```nix
{ pkgs ? import {} }:
let
NPM_PREFIX = "$HOME/.npm-global";
in
pkgs.mkShell {
inherit NPM_PREFIX;
packages = with pkgs; [
busybox
nodejs-16_x
];
N_PRESERVE_NPM = 1;
N_PREFIX = "/home/runner/.n";
shellHook = ''
npm config set prefix "${NPM_PREFIX}"
npm i -g npm@latest n typescript-language-server
export PATH="$N_PREFIX/bin:${NPM_PREFIX}/bin:$PATH"
'';
}
```
### `.replit` - Configures the run command
The run command in this file should look something like this. You can use any binary made available by your `shell.nix` file in this run command.
We assume it will be npm scripts that you want to run.
```toml
language = "nix"
run = "node -v && npm -v"
[packager]
language = "nodejs-npm"
[packager.features]
packageSearch = true
guessImports = false
[unitTest]
language = "nodejs"
[languages.javascript]
pattern = "**/*.js"
syntax = "javascript"
[languages.javascript.languageServer]
start = [ "typescript-language-server", "--stdio" ]
[nix]
channel = "unstable"
[env]
XDG_CONFIG_HOME = "/home/runner/.config"
```
You can manually restart the environment by running:
```shell
busybox reboot
```
Once both those files are configured and you add files for your language, you can run you repl like normal, with the run button.
Both the Console and Shell will pick up changes made to your `replit.nix` file. However, once you open the Shell tab, the environment will not update until you run `exit`. This will close out the existing `shell` process and start a new one that includes any changes that you made to your `replit.nix` file.
### Credits and inspiration
- [@replit/Nix-beta](https://replit.com/@replit/Nix-beta?v=1)
- [@RoBlockHead/NodeJS-16](https://replit.com/@RoBlockHead/NodeJS-16?v=1)
- [@amasad/Live-Coding-in-Nodejs](https://replit.com/@amasad/Live-Coding-in-Nodejs?v=1)
- [@ConnorBrewster/BetterNode-3](https://replit.com/@ConnorBrewster/BetterNode-3?v=1)
- [replit blog nix dynamic version](https://blog.replit.com/nix_dynamic_version)
## Learn More About Nix
If you'd like to learn more about Nix, here are some great resources:
* [Getting started with Nix](https://docs.replit.com/programming-ide/getting-started-nix) - How to use Nix on Replit
* [Nix Pills](https://nixos.org/guides/nix-pills/) - Guided introduction to Nix
* [Nixology](https://www.youtube.com/playlist?list=PLRGI9KQ3_HP_OFRG6R-p4iFgMSK1t5BHs) - A series of videos introducing Nix in a practical way
* [Nix Package Manager Guide](https://nixos.org/manual/nix/stable/) - A comprehensive guide of the Nix Package Manager
* [A tour of Nix](https://nixcloud.io/tour) - Learn the nix language itself