git.iko.soy/urbit.org
on e6a0bab help sign in
urbit.org/README.md
69 lines 2.5 kB history raw
1The website for Urbit.
3## Getting Started
5```bash
6npm install
7```
9Run the development server:
11```bash
12npm run dev
13# or
14yarn dev
15```
17Finally, open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
19### Errors with Digital Envelope Routines
21Gatsby v4 is not compatible with Webpack v4. If you're building with Node.js v17 or greater, you may experience some issues when building [urbit.org](https://urbit.org). The incompatibility between Gatsby and Webpack will present as the following error message on `yarn dev` or `npm run dev`:
23```bash
24Error: error:0308010C:digital envelope routines::unsupported
25 at new Hash (node:internal/crypto/hash:67:19)
26 at Object.createHash (node:crypto:130:10)
27 at module.exports.__webpack_modules__.15660.module.exports (~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:111680:62)
28 at NormalModule._initBuildHash (~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:85092:16)
29 at handleParseError (~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:85146:10)
30 at ~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:85178:5
31 at ~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:85033:12
32 at ~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:51096:3
33 at iterateNormalLoaders (~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:50937:10)
34 at Array.<anonymous> (~/urbit.org/node_modules/next/dist/compiled/webpack/bundle4.js:50928:4) {
35 opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
36 library: 'digital envelope routines',
37 reason: 'unsupported',
38 code: 'ERR_OSSL_EVP_UNSUPPORTED'
40```
42To work around this error, you can take the following steps:
44```bash
45npm install gatsby
46# then
47export NODE_OPTIONS=--openssl-legacy-provider
48```
50Adding the `openssl-legacy-provider` option should allow you to build the site successfully.
52## Framework and Library Documentation
54To learn more about Next.js, take a look at the following resources:
56- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
57- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
59To learn more about Tailwind CSS, take a look at the docs:
61- [Tailwind CSS Docs](https://tailwindcss.com/docs) - Docs
63## Deployment
65WIP
67## Upgrades
69The `/scripts` contains scripts used to programmatically upgrade site content data.