110 lines
1.8 KiB
Org Mode
110 lines
1.8 KiB
Org Mode
|
|
#+title: phundrak.com frontend
|
|||
|
|
#+author: Lucien Cartier-Tilet
|
|||
|
|
#+email: lucien@phundrak.com
|
|||
|
|
|
|||
|
|
This is the frontend of =phundrak.com=, written with Nuxt.
|
|||
|
|
|
|||
|
|
* Setup
|
|||
|
|
|
|||
|
|
** Environment
|
|||
|
|
*** Nix Environment
|
|||
|
|
If you use Nix, you can set up your environment using the [[file:flake.nix][=flake.nix=]]
|
|||
|
|
file, which will give you the exact same development environment as I
|
|||
|
|
use.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
nix develop
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
If you have [[https://direnv.net/][=direnv=]] installed, you can simply use it to automatically
|
|||
|
|
enable this environment. However, I *strongly* recommend you to read the
|
|||
|
|
content of the =flake.nix= file before doing so, as you should with any
|
|||
|
|
Nix-defined environment you did not create.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
direnv allow .
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
*** Required Tools
|
|||
|
|
To be able to work on this project, you need a Javascript package
|
|||
|
|
manager, such as:
|
|||
|
|
- =npm=
|
|||
|
|
- =pnpm= (recommended)
|
|||
|
|
- =yarn=
|
|||
|
|
- =bun=
|
|||
|
|
|
|||
|
|
In my case, I use pnpm.
|
|||
|
|
|
|||
|
|
You can skip this if you are already using my Nix environment.
|
|||
|
|
|
|||
|
|
** Dependencies
|
|||
|
|
Once you have your environment ready, you can now install the
|
|||
|
|
project’s dependencies.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
# npm
|
|||
|
|
npm install
|
|||
|
|
|
|||
|
|
# pnpm
|
|||
|
|
pnpm install
|
|||
|
|
|
|||
|
|
# yarn
|
|||
|
|
yarn install
|
|||
|
|
|
|||
|
|
# bun
|
|||
|
|
bun install
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
* Running the Project
|
|||
|
|
You are now ready to start the development server on
|
|||
|
|
=http://localhost:3000=.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
# npm
|
|||
|
|
npm run dev
|
|||
|
|
|
|||
|
|
# pnpm
|
|||
|
|
pnpm dev
|
|||
|
|
|
|||
|
|
# yarn
|
|||
|
|
yarn dev
|
|||
|
|
|
|||
|
|
# bun
|
|||
|
|
bun run dev
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
* Production
|
|||
|
|
Once you are satisfied with the project, you can build the application in production mode.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
# npm
|
|||
|
|
npm run build
|
|||
|
|
|
|||
|
|
# pnpm
|
|||
|
|
pnpm build
|
|||
|
|
|
|||
|
|
# yarn
|
|||
|
|
yarn build
|
|||
|
|
|
|||
|
|
# bun
|
|||
|
|
bun run build
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
You can preview locally the production build too.
|
|||
|
|
|
|||
|
|
#+begin_src bash
|
|||
|
|
# npm
|
|||
|
|
npm run preview
|
|||
|
|
|
|||
|
|
# pnpm
|
|||
|
|
pnpm preview
|
|||
|
|
|
|||
|
|
# yarn
|
|||
|
|
yarn preview
|
|||
|
|
|
|||
|
|
# bun
|
|||
|
|
bun run preview
|
|||
|
|
#+end_src
|
|||
|
|
|
|||
|
|
Check out the [[https://nuxt.com/docs/getting-started/deployment][deployment documentation]] for more information.
|