Small World

you can find the live version of Small World at: https://smallworld.kiwi

run, build, & deploy

local setup

lein install
install postgres: https://postgresapp.com (database)
run bin/setup to create a local postgres db called smallworld-local

local development

run bin/start-dev.sh
- sets the environment variables
- starts the server: http://localhost:3001
- starts the frontend hot-reloading*
- starts the repl
connect Calva repl in VSCode to the repl running in the terminal (optional – the previous step starts a repl in your terminal, so this step is just for people who prefer to use the Calva repl instead of the terminal repl)
- command in VSCode: Calva: Connect to a running REPL server in the project
- how to reload your code into the repl: Calva: Load Current File and Dependencies
- how to reload the backend code in the running server: (restart-server)

* if you want to start just the frontend hot-reloading, without the server: lein figwheel. you probably won't use this often, as lein repl starts the frontend hot-reloading as well as the server.

update code running in the repl

you have two options:

reload the entire file into the repl
- command in VSCode: Calva: load current file and dependencies
- pros: simpler because it just reloads everything that file needs, so you don't need to worry about it
- cons: slower
evaluate just the form that you want to update in the code
- e.g. you can evaluate just the `(defroutes app ...) form if you updated code within
- pros: faster
- cons: more likely that you forget to evaluate a dependency that's needed and the whole thing doesn't actually update as you expect

deploy to Heroku

bin/make-and-deploy.sh

here are the steps that script follows, broken down into separate subscripts:

build a production version
```
bin/make-jar.sh
```
optional: run the jar locally to make sure it works, and open it at http://localhost:8080
```
bin/run-jar.sh
```
deploy the jar to heroku
```
bin/deploy
```
view heroku logs to check if deployment succeeded
```
bin/heroku-logs.sh
```

initial designs

🎨 Figma workspace

emails

the server sends emails via SendGrid. view/edit the templates here: https://mc.sendgrid.com/dynamic-templates

Monitoring

We use:

https://analytics.google.com to view website traffic
https://tryretool.com as a dashboard to view the database and other metrics
https://my.papertrailapp.com to view server logs

sql cheatsheet

open Heroku Postgres instance in terminal (or you can view the data in a GUI with Postbird):
```
bin/postgres-heroku.sh
```
open local Postgres instance in terminal:
```
bin/postgres-local.sh
```

view all tables:

select table_name from information_schema.tables
where  table_schema = 'public';

make a user go through welcome flow again:

update settings set    welcome_flow_complete = false
where  screen_name           = 'devon_dos';

get column names of a table:

select column_name, data_type
from   information_schema.columns
where  table_name = 'friends';

reset a user: (BE CAREFUL, THIS IS VERY DESTRUCTIVE!)

delete from twitter_profiles where request_key = 'devon_dos';
delete from friends          where request_key = 'devon_dos';
delete from settings         where screen_name = 'devon_dos';
delete from access_tokens    where request_key = 'devon_dos';

add a column:

ALTER TABLE "settings" ADD COLUMN locations jsonb;

misc commands cheatsheet

run command line inside of Heroku:

heroku ps:exec --app=small-world-friends

view environment variables for process with pid 4:
```
cat /proc/4/environ | tr '\0' '\n'
```

run prod jar locally:

lein uberjar # builds the jar
java -Xmx300m -Xss512k -XX:CICompilerCount=2 -Dfile.encoding=UTF-8 -jar target/smallworld.jar -m smallworld.web

MeetCute

how the matchmaking algorithm works

each user has N lists of cuties:
- unseen-cuties: the cuties the user hasn't seen yet
- todays-cutie: the cutie the user is currently seeing
- selected-cuties: the cuties the user has selected
- rejected-cuties: the cuties the user has rejected
each night, there's a cron job that runs and does the following:
1. pick a random* cutie from the unseen list
  - *the cutie has to meet the user's criteria (sexual orientation, etc)
  - in the future, the selection will be more sophisticated, but for now, it's just random
  - if the user has no unseen cuties, then leave it blank
2. add it to the todays-cutie list
3. remove that cutie from the unseen list

invariants that should be true:

each cutie should be in exactly 1 of the 3 lists at a time (unseen-, selected-, or rejected-)
the todays-cutie list should always have 0 or 1 cuties; that cutie will also be in one of unseen-, selected-, or rejected-
if unseen is empty for any given user, email the admin to let them know that they need to add more cuties to the db

branding ideas

"cuties"
"we'll have a fresh cutie for you tomorrow!"
orange favicon
"media naranja" (spanish for "half orange", their word for "soulmate")
for valentine's day, we can do corny citrus puns like:
- "squeeze the day!"
- "you're the zest"
- "will you be my clementine?"
- "you're a cutie"
- "you're my main squeeze"
- "you're the zest"
- "you're a-peeling"
- "you're the apple of my eye"
- "orange you glad we met?"
- "you're berry special to me"
- "you're the cherry on top"
- "you're the pineapple of my eye"
- "you're the lime to my coconut"
- "I'm grapefruit-ful for your love!"
- "you're one in a melon!"

TODO before launch

features

add an orange favicon
implement the "today's cutie" screen
get Twilio account unsuspended
implement the matchmaking algorithm
- debug: the unseen-cuties order gets messed up, not sure why... probably something to do with (a) memoization or (b) not fetching the profile frequently enough
- refresh-todays-cutie is still buggy... sometimes people end up in 2 lists, when they should only ever be in 1... consider adding assertions to check this
implement the email that gets sent to the user when their todays-cutie is refreshed
opengraph image
admin page: add button to refresh everyone's todays-cutie list

last-minute admin before it's usable

nice-to-haves, but not necessary for alpha launch to friends:

before we launch the public beta:

nice to have later on:

not that important

key design decisions:

not including age
1 cutie per day – compared to dating apps, which implicitly commodify people Now
friends' vouches
friends of friends
dinners
small photos

Empact/smallworld