]> git.openstreetmap.org Git - nominatim-ui.git/blobdiff - CONTRIBUTE.md
avoid build warning by reassigning Nominatim_Config in script section
[nominatim-ui.git] / CONTRIBUTE.md
index de818e86ad548e4e91d00e7ce7c1e643edba3311..66251bebd4be950c08c25dd9fb1f86c428a49ab0 100644 (file)
@@ -1,15 +1,15 @@
 # Developing Nominatim-UI
 
+[![Continuous Integration](https://github.com/osm-search/nominatim-ui/actions/workflows/ci.yml/badge.svg)](https://github.com/osm-search/nominatim-ui/actions/workflows/ci.yml)
+
 ## Background
 
 The user interface used to be included in the geocoder. Thus the
 first version avoid being a redesign and still uses some of the
-same configuration values. For simplicity it's not a single
-page application (SPA) written in a framework though it could
-be in the future if complexity grows.
+same configuration values. Version 2 was a full refactor using
+Svelte. Version 3 added theme and easier configuration.
 
-Uses [jQuery](https://jquery.com/) for browser DOM interaction,
-[handlebar](http://handlebarsjs.com/) templates to build pages,
+Uses [svelte](https://svelte.dev/) framework,
 [leaflet](https://leafletjs.com/) for map interaction,
 [bootstrap](https://getbootstrap.com/) for layout styling.
 
@@ -25,16 +25,14 @@ Uses [jQuery](https://jquery.com/) for browser DOM interaction,
 * After you change files in `src` directory run
 
    ```
-   yarn build
+   yarn dev
    ```
+   which will start a webserver on port 9880 and auto-reloads
+   whenever you edit files.
 
-* Start a webserver on port 8000 to preview changes
-
-   ```
-   yarn start
-   ```
+## Testing
 
-* Run code style check
+* Run syntax linter
 
    ```
    yarn lint
@@ -50,4 +48,5 @@ Uses [jQuery](https://jquery.com/) for browser DOM interaction,
 
 4. Tag release: `git tag THE_VERSION_NUMBER`, `git push --tags`
 
-5. Upload release
\ No newline at end of file
+5. Create release on https://github.com/osm-search/nominatim-ui/releases
+   This (a triggered Github Action) will run `yarn build` and add the `dist/build/bundle.*` files.