mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-15 09:01:09 +02:00
c712a2504a
- Add uload project with apps/web structure
- Reorganize from flat to monorepo structure
- Remove PocketBase binary and local data
- Update to pnpm and @uload/web namespace
- Add picture project to monorepo
- Remove embedded git repository
- Unify all package names to @{project}/{app} schema:
- @maerchenzauber/* (was @storyteller/*)
- @manacore/* (was manacore-*, manacore)
- @manadeck/* (was web, backend, manadeck)
- @memoro/* (was memoro-web, landing, memoro)
- @picture/* (already unified)
- @uload/web
- Add convenient dev scripts for all apps:
- pnpm dev:{project}:web
- pnpm dev:{project}:landing
- pnpm dev:{project}:mobile
- pnpm dev:{project}:backend
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
121 lines
No EOL
2.1 KiB
Markdown
121 lines
No EOL
2.1 KiB
Markdown
# Redis Cache - Quick Start Guide
|
|
|
|
## 🚀 5-Minute Setup
|
|
|
|
### macOS/Linux
|
|
|
|
```bash
|
|
# 1. Install Redis
|
|
brew install redis
|
|
|
|
# 2. Start Redis
|
|
brew services start redis
|
|
|
|
# 3. Add to .env.development
|
|
echo "REDIS_HOST=localhost" >> .env.development
|
|
echo "REDIS_PORT=6379" >> .env.development
|
|
echo "REDIS_PASSWORD=" >> .env.development
|
|
|
|
# 4. Start app
|
|
npm run dev
|
|
|
|
# 5. Verify
|
|
curl http://localhost:5173/api/redis-status
|
|
```
|
|
|
|
### Windows (WSL2)
|
|
|
|
```bash
|
|
# 1. Install Redis in WSL2
|
|
sudo apt update
|
|
sudo apt install redis-server
|
|
|
|
# 2. Start Redis
|
|
sudo service redis-server start
|
|
|
|
# 3. Configure (same as macOS)
|
|
```
|
|
|
|
### Docker
|
|
|
|
```bash
|
|
# 1. Run Redis container
|
|
docker run -d -p 6379:6379 --name uload-redis redis:alpine
|
|
|
|
# 2. Configure (same as above)
|
|
```
|
|
|
|
## ✅ Verify It's Working
|
|
|
|
### Check Connection
|
|
|
|
```bash
|
|
# Should return: PONG
|
|
redis-cli ping
|
|
```
|
|
|
|
### Check App Status
|
|
|
|
Visit: http://localhost:5173/api/redis-status
|
|
|
|
Should see:
|
|
```json
|
|
{
|
|
"connected": true,
|
|
"available": true
|
|
}
|
|
```
|
|
|
|
### Test Cache Performance
|
|
|
|
1. Create a short link
|
|
2. Visit it (slow - cache miss)
|
|
3. Visit again (fast - cache hit!)
|
|
4. Check console for "Cache HIT!" message
|
|
|
|
## 🛠 Common Commands
|
|
|
|
```bash
|
|
# View all cached links
|
|
redis-cli keys "redirect:*"
|
|
|
|
# Clear cache
|
|
redis-cli flushall
|
|
|
|
# Monitor activity
|
|
redis-cli monitor
|
|
|
|
# Stop Redis
|
|
brew services stop redis
|
|
```
|
|
|
|
## 🔥 Quick Tips
|
|
|
|
1. **No Password Locally**: Leave REDIS_PASSWORD empty for local dev
|
|
2. **Auto-Fallback**: App works without Redis (just slower)
|
|
3. **Hot Reload**: Changes to Redis config need server restart
|
|
4. **Memory**: Redis uses ~50MB for thousands of links
|
|
|
|
## 📚 Learn More
|
|
|
|
- [Detailed Setup Guide](./redis-local-setup.md)
|
|
- [Architecture Overview](./redis-architecture.md)
|
|
- [Production Setup](./redis-production-setup.md)
|
|
|
|
## 🆘 Help
|
|
|
|
**Redis won't start?**
|
|
```bash
|
|
brew services restart redis
|
|
```
|
|
|
|
**Connection refused?**
|
|
```bash
|
|
# Check if running
|
|
ps aux | grep redis
|
|
```
|
|
|
|
**Cache not working?**
|
|
- Check console for Redis connection message
|
|
- Verify environment variables are loaded
|
|
- Try explicit env vars: `REDIS_HOST=localhost npm run dev` |