From a53178cab9d1e2b533b6f125939e9300e31a60fd Mon Sep 17 00:00:00 2001
From: sabaimran <65192171+sabaimran@users.noreply.github.com>
Date: Sat, 22 Jun 2024 07:42:41 -0700
Subject: [PATCH] Add developer support for using next.js to serve generated
static files (#814)
To improve the developer experience for front-end development, we're migrating to Next.js. In order to do this migration page-by-page, we're using static site generation via Next.js. This also helps us avoid making cross site requests from front-end to back-end for the time being, while giving a ramp to separating out server and client if needed for scale down the road.
Dev instructions for using the next.js setup are in the added README.
This adds scaffolding for including the built files in the python package as well as the docker images. Docker setup has been tested locally. In order to verify the build is working as expected, we can navigate to the {khoj_host}:42110/experimental and verify that the experiment page comes up.
This setup works with serving static files included in the src/interface/web folder from the Django app. The key bit for understanding the setup is in the yarn export command in package.json.
---
.github/workflows/dockerize.yml | 4 +-
.github/workflows/pypi.yml | 12 +
.gitignore | 1 +
Dockerfile | 15 +-
documentation/assets/img/logo.svg | 1 -
prod.Dockerfile | 14 +-
src/interface/web/.env.development | 1 +
src/interface/web/.env.production | 1 +
src/interface/web/.eslintrc.json | 3 +
src/interface/web/.gitignore | 36 +
src/interface/web/README.md | 93 +
src/interface/web/app/favicon.ico | Bin 0 -> 205167 bytes
src/interface/web/app/globals.css | 158 +
src/interface/web/app/layout.tsx | 22 +
src/interface/web/app/page.module.css | 230 +
src/interface/web/app/page.tsx | 9 +
src/interface/web/image-loader.ts | 19 +
src/interface/web/next.config.mjs | 38 +
src/interface/web/package.json | 39 +
src/interface/web/public/agents.svg | 6 +
src/interface/web/public/automation.svg | 37 +
src/interface/web/public/chat.svg | 24 +
src/interface/web/public/close.svg | 5 +
.../web/public/copy-button-success.svg | 6 +
src/interface/web/public/copy-button.svg | 5 +
src/interface/web/public/khoj-logo.svg | 5385 +++++++++++++++++
src/interface/web/public/send.svg | 1 +
src/interface/web/public/share.svg | 8 +
src/interface/web/public/thumbs-down.svg | 6 +
src/interface/web/public/thumbs-up.svg | 6 +
src/interface/web/tsconfig.json | 40 +
src/interface/web/yarn.lock | 2581 ++++++++
src/khoj/app/settings.py | 2 +-
src/khoj/configure.py | 13 +
src/khoj/routers/web_client.py | 13 +-
src/khoj/utils/constants.py | 1 +
36 files changed, 8828 insertions(+), 7 deletions(-)
delete mode 100644 documentation/assets/img/logo.svg
create mode 100644 src/interface/web/.env.development
create mode 100644 src/interface/web/.env.production
create mode 100644 src/interface/web/.eslintrc.json
create mode 100644 src/interface/web/.gitignore
create mode 100644 src/interface/web/README.md
create mode 100644 src/interface/web/app/favicon.ico
create mode 100644 src/interface/web/app/globals.css
create mode 100644 src/interface/web/app/layout.tsx
create mode 100644 src/interface/web/app/page.module.css
create mode 100644 src/interface/web/app/page.tsx
create mode 100644 src/interface/web/image-loader.ts
create mode 100644 src/interface/web/next.config.mjs
create mode 100644 src/interface/web/package.json
create mode 100644 src/interface/web/public/agents.svg
create mode 100644 src/interface/web/public/automation.svg
create mode 100644 src/interface/web/public/chat.svg
create mode 100644 src/interface/web/public/close.svg
create mode 100644 src/interface/web/public/copy-button-success.svg
create mode 100644 src/interface/web/public/copy-button.svg
create mode 100644 src/interface/web/public/khoj-logo.svg
create mode 100644 src/interface/web/public/send.svg
create mode 100644 src/interface/web/public/share.svg
create mode 100644 src/interface/web/public/thumbs-down.svg
create mode 100644 src/interface/web/public/thumbs-up.svg
create mode 100644 src/interface/web/tsconfig.json
create mode 100644 src/interface/web/yarn.lock
diff --git a/.github/workflows/dockerize.yml b/.github/workflows/dockerize.yml
index 50b8e0ed..95a915f8 100644
--- a/.github/workflows/dockerize.yml
+++ b/.github/workflows/dockerize.yml
@@ -8,6 +8,7 @@ on:
- master
paths:
- src/khoj/**
+ - src/interface/web/**
- pyproject.toml
- Dockerfile
- prod.Dockerfile
@@ -30,8 +31,9 @@ on:
env:
# Tag Image with tag name on release
# else with user specified tag (default 'dev') if triggered via workflow
+ # else with run_id if triggered via a pull request
# else with 'pre' (if push to master)
- DOCKER_IMAGE_TAG: ${{ github.ref_type == 'tag' && github.ref_name || github.event_name == 'workflow_dispatch' && github.event.inputs.tag || 'pre' }}
+ DOCKER_IMAGE_TAG: ${{ github.ref_type == 'tag' && github.ref_name || github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.event_name == 'push' && github.run_id || 'pre' }}
jobs:
build:
diff --git a/.github/workflows/pypi.yml b/.github/workflows/pypi.yml
index 92bf9276..79fab443 100644
--- a/.github/workflows/pypi.yml
+++ b/.github/workflows/pypi.yml
@@ -8,6 +8,7 @@ on:
- 'master'
paths:
- src/khoj/**
+ - src/interface/web/**
- pyproject.toml
- .github/workflows/pypi.yml
pull_request:
@@ -15,6 +16,7 @@ on:
- 'master'
paths:
- src/khoj/**
+ - src/interface/web/**
- pyproject.toml
- .github/workflows/pypi.yml
@@ -37,6 +39,16 @@ jobs:
- name: ⬇️ Install Application
run: python -m pip install --upgrade pip && pip install --upgrade .
+ - name: Install the Next.js application
+ run: |
+ yarn install
+ working-directory: src/interface/web
+
+ - name: Build & export static Next.js app to Django static assets
+ run: |
+ yarn ciexport
+ working-directory: src/interface/web
+
- name: ⚙️ Build Python Package
run: |
# Setup Environment for Reproducible Builds
diff --git a/.gitignore b/.gitignore
index 35315263..18e05eb9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@ todesktop.json
# Build artifacts
/src/khoj/interface/web/images
+/src/khoj/interface/built/
/build/
/dist/
khoj_assistant.egg-info
diff --git a/Dockerfile b/Dockerfile
index c042a6d1..d091e730 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -3,11 +3,17 @@ FROM ubuntu:jammy
LABEL org.opencontainers.image.source https://github.com/khoj-ai/khoj
# Install System Dependencies
-RUN apt update -y && apt -y install python3-pip swig
+RUN apt update -y && apt -y install python3-pip swig curl
-WORKDIR /app
+# Install Node.js and Yarn
+RUN curl -sL https://deb.nodesource.com/setup_22.x | bash -
+RUN apt -y install nodejs
+RUN curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
+RUN echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list
+RUN apt update && apt -y install yarn
# Install Application
+WORKDIR /app
COPY pyproject.toml .
COPY README.md .
ARG VERSION=0.0.0
@@ -20,6 +26,11 @@ COPY . .
# Set the PYTHONPATH environment variable in order for it to find the Django app.
ENV PYTHONPATH=/app/src:$PYTHONPATH
+# Go to the directory src/interface/web and export the built Next.js assets
+WORKDIR /app/src/interface/web
+RUN bash -c "yarn install && yarn ciexport"
+WORKDIR /app
+
# Run the Application
# There are more arguments required for the application to run,
# but these should be passed in through the docker-compose.yml file.
diff --git a/documentation/assets/img/logo.svg b/documentation/assets/img/logo.svg
deleted file mode 100644
index ad9d11a4..00000000
--- a/documentation/assets/img/logo.svg
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/prod.Dockerfile b/prod.Dockerfile
index 0da5363a..47a8a232 100644
--- a/prod.Dockerfile
+++ b/prod.Dockerfile
@@ -3,7 +3,14 @@ FROM ubuntu:jammy
LABEL org.opencontainers.image.source https://github.com/khoj-ai/khoj
# Install System Dependencies
-RUN apt update -y && apt -y install python3-pip libsqlite3-0 ffmpeg libsm6 libxext6
+RUN apt update -y && apt -y install python3-pip libsqlite3-0 ffmpeg libsm6 libxext6 swig curl
+
+# Install Node.js and Yarn
+RUN curl -sL https://deb.nodesource.com/setup_22.x | bash -
+RUN apt -y install nodejs
+RUN curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
+RUN echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list
+RUN apt update && apt -y install yarn
WORKDIR /app
@@ -20,6 +27,11 @@ COPY . .
# Set the PYTHONPATH environment variable in order for it to find the Django app.
ENV PYTHONPATH=/app/src:$PYTHONPATH
+# Go to the directory src/interface/web and export the built Next.js assets
+WORKDIR /app/src/interface/web
+RUN bash -c "yarn install && yarn ciexport"
+WORKDIR /app
+
# Run the Application
# There are more arguments required for the application to run,
# but these should be passed in through the docker-compose.yml file.
diff --git a/src/interface/web/.env.development b/src/interface/web/.env.development
new file mode 100644
index 00000000..6e1d6c66
--- /dev/null
+++ b/src/interface/web/.env.development
@@ -0,0 +1 @@
+NEXT_PUBLIC_ENV='development'
diff --git a/src/interface/web/.env.production b/src/interface/web/.env.production
new file mode 100644
index 00000000..bfcbde2a
--- /dev/null
+++ b/src/interface/web/.env.production
@@ -0,0 +1 @@
+NEXT_PUBLIC_ENV='production'
diff --git a/src/interface/web/.eslintrc.json b/src/interface/web/.eslintrc.json
new file mode 100644
index 00000000..bffb357a
--- /dev/null
+++ b/src/interface/web/.eslintrc.json
@@ -0,0 +1,3 @@
+{
+ "extends": "next/core-web-vitals"
+}
diff --git a/src/interface/web/.gitignore b/src/interface/web/.gitignore
new file mode 100644
index 00000000..fd3dbb57
--- /dev/null
+++ b/src/interface/web/.gitignore
@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/src/interface/web/README.md b/src/interface/web/README.md
new file mode 100644
index 00000000..4196c5c7
--- /dev/null
+++ b/src/interface/web/README.md
@@ -0,0 +1,93 @@
+This is a [Next.js](https://nextjs.org/) project.
+
+## Getting Started
+
+First, install the dependencies:
+
+```bash
+yarn install
+```
+
+In case you run into any dependency linking issues, you can try running:
+
+```bash
+yarn add next
+```
+
+### Run the development server:
+
+```bash
+yarn dev
+```
+
+Make sure the `rewrites` in `next.config.mjs` are set up correctly for your environment. The rewrites are used to proxy requests to the API server.
+
+```js
+ rewrites: async () => {
+ return [
+ {
+ source: '/api/:path*',
+ destination: 'http://localhost:42110/api/:path*',
+ },
+ ];
+ },
+```
+
+The `destination` should be the URL of the API server.
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying any of the `.tsx` pages. The page auto-updates as you edit the file.
+
+### Testing built files
+
+We've setup a utility command for building and serving the built files. This is useful for testing the production build locally.
+
+1. Exporting code
+To build the files once and serve them, run:
+```bash
+yarn export
+```
+
+If you're using Windows:
+```bash
+yarn windowsexport
+```
+
+
+2. Continuously building code
+
+To keep building the files and serving them, run:
+```bash
+yarn watch
+```
+
+If you're using Windows:
+```bash
+yarn windowswatch
+```
+
+Now you should be able to load your custom pages from the Khoj app at http://localhost:42110/. To server any of the built files, you should update the routes in the `web_client.py` like so, where `new_file` is the new page you've added in this repo:
+
+```python
+@web_client.post("/new_route", response_class=FileResponse)
+@requires(["authenticated"], redirect="login_page")
+def index_post(request: Request):
+
+ return templates.TemplateResponse(
+ "new_file/index.html",
+ context={
+ "request": request,
+ },
+ )
+```
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Next.js App Router](https://nextjs.org/docs/app) - learn about the Next.js router.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
diff --git a/src/interface/web/app/favicon.ico b/src/interface/web/app/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..ed751b2d14935cd7772f94fcde5b47e7a012a08d
GIT binary patch
literal 205167
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