GlobalBookShelf/global-bookshelf

AI-powered literary platform for African and multilingual literature # Global BookShelf — Complete Backend & Mobile Stack ## What is in this package | File | What it is | |---|---| | `server.js` | Node.js + Express API — full backend (auth, books, soul, payments, admin) | | `soul_engine.py` | Python AI Soul Engine — 14-dimension profile + 1536-dim embeddings | | `admin-dashboard.html` | Admin dashboard — stats, payments, moderation, user management | | `App.tsx` | React Native mobile app — iOS + Android | | `.env.example` | All environment variables with explanations | --- ## Quick Start — Run Everything in 5 Steps ### Step 1 — Copy environment config ```bash cp .env.example .env # Edit .env — add your Stripe key for Visa card payments ``` ### Step 2 — Start the Node.js API server ```bash npm install # installs express, stripe, bcryptjs, jsonwebtoken, etc. node server.js # starts on localhost ``` You will see: ``` ╔═══════════════════════════════════════════════════╗ ║ GLOBAL BOOKSHELF API SERVER ║ ║ Port : 4000 ║ ╚═══════════════════════════════════════════════════╝ ``` ### Step 3 — Start the Python AI Soul Engine ```bash python3 soul_engine.py # starts on localhost ``` ### Step 4 — Open the Admin Dashboard ```bash open admin-dashboard.html # macOS # or drag the file into any browser ``` ### Step 5 — Run the Mobile App ```bash npx create-expo-app GlobalBookShelf --template blank-typescript cd GlobalBookShelf npm install @stripe/stripe-react-native @react-navigation/native @react-navigation/bottom-tabs # Copy App.tsx into the project root npx expo start ``` --- ## Visa Card Payment Setup ### How it works 1. User selects a patron tier (Story Friend $5, Chapter Keeper $12, Soul Patron $28) 2. User enters their Visa card number, expiry, and CVV on the mobile app 3. The app tokenises the card via Stripe (card number NEVER sent to our server) 4. Our API receives only a Stripe `paymentMethod.id` token 5. We create a monthly …