|
1 year ago | |
---|---|---|
.. | ||
content/blog | 2 years ago | |
scripts | 1 year ago | |
src | 1 year ago | |
static | 1 year ago | |
.env | 1 year ago | |
.eslintrc.cjs | 2 years ago | |
.gitignore | 1 year ago | |
.prettierrc | 1 year ago | |
README.md | 2 years ago | |
config.js | 2 years ago | |
package-lock.json | 1 year ago | |
package.json | 1 year ago | |
svelte.config.js | 1 year ago | |
tsconfig.json | 2 years ago | |
vite.config.js | 1 year ago |
README.md
Running locally
A local database is only required in dev mode if you want to test reading and writing saved REPLs on it. Without a local database in dev mode, the REPL will be able to load saved REPLs from the production database, but not save them.
Note also that in dev mode, the REPL will currently only work in Chrome, as noted in the Vite documentation, pending support in Firefox for import
statements in web workers.
If you do want to use a database, set it up on Supabase with the instructions here and set the corresponding environment variables.
Run the site sub-project:
pnpm install
pnpm dev
and navigate to localhost:5173.
The first time you run the site locally, it will update the list of Contributors and REPL dependencies. After this it won't run again unless you force it by running:
pnpm update
Running using the local copy of Svelte
By default, the REPL will fetch the most recent version of Svelte from https://unpkg.com/svelte. When running the site locally, you can also use your local copy of Svelte.
To produce the proper browser-compatible UMD build of the compiler, you will need to run npm run build
(or npm run dev
) in the svelte
repository with the PUBLISH
environment variable set to any non-empty string:
git clone https://github.com/sveltejs/svelte.git
cd svelte
npm ci
PUBLISH=1 npm run build
The default configuration assumes that the sites
repository and the svelte
repository are in the same directory. If not, you can set LOCAL_SVELTE_PATH
in sites/svelte.dev/.env
to a different path to the local copy of Svelte.
Then visit the REPL at localhost:5173/repl?version=local. Please note that the local REPL only works with pnpm dev
and not when building the site for production usage.
REPL GitHub integration
In order for the REPL's GitHub integration to work properly when running locally, you will need to:
- create a GitHub OAuth app:
- set
Authorization callback URL
tohttp://localhost:5173/auth/callback
; - set
Application name
as you like, andHomepage URL
ashttp://localhost:5173/
; - create the app and take note of
Client ID
andClient Secret
- set
- in this directory, create an
.env.local
file (see.env.example
) containing:GITHUB_CLIENT_ID=[your app's Client ID] GITHUB_CLIENT_SECRET=[your app's Client Secret]
The GitHub app requires a specific callback URL, and so cannot be used with the preview deployment in the staging environment.
Building the site
To build the website, run pnpm build
. The output can be found in build
.
Testing
Tests can be run using pnpm test
.
Translating the API docs
Anchors are automatically generated using headings in the documentation and by default (for the english language) they are latinised to make sure the URL is always conforming to RFC3986.
If we need to translate the API documentation to a language using unicode chars, we can setup this app to export the correct anchors by setting up SLUG_PRESERVE_UNICODE
to true
in config.js
.