Skip to content

Commit d0818ea

Browse files
committed
Update tools used for PoWA-Web development
1 parent 9c8e44f commit d0818ea

File tree

1 file changed

+23
-15
lines changed

1 file changed

+23
-15
lines changed

docs/components/powa-web/development.rst

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -17,27 +17,35 @@ Clone the repository:
1717
.. code:: bash
1818
1919
git clone https://github.com/powa-team/powa-web/
20-
cd powa/
21-
make && sudo make install
20+
cd powa-web/
2221
23-
To run the application, use run_powa.py, which will run powa in debug mode.
24-
That means the javascript files will not be minified, and will not be compiled
25-
into one giant source file.
22+
Then, create a Python3 virtualenv and install the project dependencies:
2623

24+
.. code:: bash
25+
26+
python3 -m venv .venv --upgrade-deps
27+
. .venv/bin/activate
28+
pip install -r requirements.txt
2729
28-
CSS files are generated using `sass <https://sass-lang.com/>`.
29-
Javascript files are splitted into AMD modules, which are managed by `requirejs
30-
<https://requirejs.org/>` and compiled using `grunt <https://gruntjs.com/>`.
30+
In case you want to contribute on the styles, first install the NodeJS dev dependencies:
31+
32+
.. code:: bash
3133
32-
These projects depend on NodeJS, and NPM, its package manager, so make sure you are able to install them on your
33-
distribution.
34+
npm ci
3435
35-
Install the development dependencies:
36+
After installing the dependencies, you can start the ViteJS development server with:
3637

3738
.. code:: bash
3839
39-
npm install -g grunt-cli
40-
npm install .
40+
npm run dev
41+
42+
This command launches a local server at http://localhost:5173 with hot module replacement,
43+
enabling real-time updates as you modify the project files.
44+
45+
To run the application, use ``run_powa.py``, which will run powa in debug mode.
46+
47+
This version uses `ViteJS` and `Vue 3` for a more integrated and performant
48+
front-end development experience.
4149

42-
Then, you can run ``grunt`` to update only the css files, or regenerate optimized
43-
javascript builds with ``grunt dist``.
50+
To easily deploy an environment for PoWa web development, take a look at `powa-podman <https://github.com/powa-team/powa-podman/tree/master/dev>`_.
51+

0 commit comments

Comments
 (0)