# SkateSpots — Zapstore Publishing Guide

Get SkateSpots on [Zapstore](https://zapstore.dev) as a native Android APK.

## Prerequisites (install on your machine)

1. **Node.js 18+** — https://nodejs.org
2. **Java 17** — https://adoptium.net
3. **Android Studio** — https://developer.android.com/studio
   - After install: open Android Studio → SDK Manager → install Android SDK 34
4. **Go** (for `zsp` CLI) — https://go.dev/dl/

---

## Step 1 — Clone & install

```bash
git clone nostr://npub1yrnuj56rnen08zp2h9h7p74ghgjx6ma39spmpj6w9hzxywutevsst7k5cx/git.shakespeare.diy/SkateSpots
cd SkateSpots
npm install
```

---

## Step 2 — Install Capacitor

```bash
npm install @capacitor/core @capacitor/cli @capacitor/android
npm install @capacitor/splash-screen @capacitor/status-bar @capacitor/keyboard
```

---

## Step 3 — Initialize Android project

```bash
npm run android:init
```

This:
- Builds the web app into `dist/`
- Creates the `android/` folder with a full Android project
- Copies your web build into the Android WebView

---

## Step 4 — Add app icons

Copy your icon files into the Android resources:

```bash
# The app already has icons in public/images/
# After android:init, copy them:
cp public/images/icon-1024.png android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
```

Or use Android Studio: right-click `app` → New → Image Asset → import `public/images/icon-1024.png`

---

## Step 5 — Generate a signing keystore (one-time)

```bash
keytool -genkey -v \
  -keystore skatespots-release.jks \
  -alias skatespots \
  -keyalg RSA \
  -keysize 2048 \
  -validity 10000 \
  -dname "CN=SkateSpots, OU=SkateSpots, O=SkateSpots, L=Bangkok, S=Bangkok, C=TH"
```

**Save the keystore file and passwords somewhere safe — you need them for every future release.**

---

## Step 6 — Build the release APK

```bash
npm run android:build
```

Or manually with signing:

```bash
npm run build
npx cap sync android
cd android
./gradlew assembleRelease \
  -Pandroid.injected.signing.store.file=../skatespots-release.jks \
  -Pandroid.injected.signing.store.password=YOUR_STORE_PASSWORD \
  -Pandroid.injected.signing.key.alias=skatespots \
  -Pandroid.injected.signing.key.password=YOUR_KEY_PASSWORD
```

APK output: `android/app/build/outputs/apk/release/app-release.apk`

---

## Step 7 — Install zsp (Zapstore CLI)

```bash
go install github.com/zapstore/zsp@latest
export PATH=$PATH:$(go env GOPATH)/bin
```

---

## Step 8 — Publish to Zapstore

```bash
SIGN_WITH=nsec1skg6sa4eqxgy6g4tauhfhf5vs4v89ja76mxgajc770jqf7jquqjq2pt8z7 zsp publish --wizard
```

The wizard will:
1. Ask for your APK path → point to `android/app/build/outputs/apk/release/app-release.apk`
2. Link your APK signing certificate to your Nostr identity (one-time NIP-C1 proof)
3. Publish the app event to Zapstore's relay

**Note:** `zapstore.yaml` is already committed to the repo — Zapstore will use it to verify your identity automatically.

---

## Step 9 — Verify on Zapstore

Visit: https://zapstore.dev/app/org.skatespots.app

Or search "SkateSpots" in the Zapstore app.

---

## Updating the app

For future releases:

```bash
# 1. Build new APK
npm run android:build

# 2. Publish new version
SIGN_WITH=nsec1... zsp publish -r git.shakespeare.diy/skatespots/SkateSpots
```

---

## Android project structure

```
android/
├── app/
│   ├── src/main/
│   │   ├── assets/public/    ← your web app lives here (auto-synced)
│   │   ├── res/              ← icons, splash screens
│   │   └── AndroidManifest.xml
│   └── build/outputs/apk/release/app-release.apk  ← built APK
├── capacitor.settings.gradle
└── build.gradle
```

## Troubleshooting

**`ANDROID_HOME` not set:**
```bash
export ANDROID_HOME=$HOME/Library/Android/sdk  # macOS
export ANDROID_HOME=$HOME/Android/Sdk           # Linux
export PATH=$PATH:$ANDROID_HOME/platform-tools
```

**Gradle build fails:**
- Make sure Java 17 is active: `java -version`
- Switch with: `export JAVA_HOME=$(/usr/libexec/java_home -v 17)`

**WebSocket connections blocked:**
- Already handled — `capacitor.config.ts` sets `allowMixedContent: true`