summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorlens <lens@neural.garden>2021-03-23 21:10:11 +0000
committerlens <lens@neural.garden>2021-03-23 21:10:11 +0000
commitcc1d0c52e104245f9f1c0d77eb24a5a33800be38 (patch)
tree02d8483dfe47803525b926a43c582dcfbf61c5db /README.md
parent81c673f058fda04b96baae7b2302f876479bc0a9 (diff)
parent7a3ec205e001e4c071a67ecc5c375612fa72afdc (diff)
Merge branch 'master' of asdf.us:swimmer
Diffstat (limited to 'README.md')
-rw-r--r--README.md32
1 files changed, 20 insertions, 12 deletions
diff --git a/README.md b/README.md
index 0daf5db..9e8cca6 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,19 @@
-# swimmer
+# Swimmer
Network-based tile tool.
-## installation
+## Installation
First, install miniconda and node.
```
conda create env -f environment.yml
-npm install
+yarn install
```
(this should work on Linux as well but let me know if it doesn't)
-## running the site
+## Running the site
Before running the commands, enter the client directory, load the Conda environment, and make sure the database is current:
@@ -26,19 +26,18 @@ conda activate swimmer
Then build the frontend and run the Flask server:
```
-npm run build:dev
-./cli.py flask run
+yarn build:dev
+yarn server
```
The server will be running on http://0.0.0.0:5000/
-
-## development
+## Development
Monitor the Javascript for changes (run in another window):
```
-npm run watch
+yarn watch
```
Generate a new migration if you've modified the database:
@@ -48,10 +47,19 @@ Generate a new migration if you've modified the database:
./cli.py db upgrade head
```
-## building the site
+Run the frontend demo flask server (port 3000):
```
-npm run build:production
-./cli.py site export --graph swimmer
+yarn demo
```
+To programmatically create pages, modify `cli/commands/site/populate.py`
+
+## Deploying a site
+
+A hypothetical rsync command:
+
+```
+cd data_store/exports/
+rsync -rlptuvz ./last-museum/ lens@garden:swimmer/data_store/exports/last-museum/
+```