Serika.art is a clean, modern Danbooru-style image board built from the ground up with Next.js 16. It features a beautiful responsive UI, comprehensive tagging system, user authentication via Serika Accounts, and a native Android app for mobile users.
| 🖼️ Gallery | 🔍 Search | 📱 Mobile |
|---|---|---|
| Browse thousands of curated images | Powerful tag-based filtering | Native Android app available |
| Feature | Description |
|---|---|
| 🎨 Modern UI | Beautiful, responsive design with dark mode and smooth animations |
| 🔐 Authentication | Secure login via Serika Accounts (accounts.serika.dev) |
| 📤 Image Upload | Drag-and-drop upload with automatic thumbnail generation |
| 🏷️ Smart Tagging | Comprehensive tag system with auto-suggestions and categories |
| 🔍 Advanced Search | Filter by tags, rating, AI status, date, and more |
| ⭐ Interactions | Upvote, downvote, favorite, and comment on images |
| 👤 User Profiles | Customizable profiles with upload history and favorites |
| 🤖 AI Detection | Mark and filter AI-generated content |
- Rating System — Safe, Questionable, and Explicit content ratings
- Artist Pages — Dedicated pages for artists with their full portfolio
- Tag Wiki — Community-maintained tag descriptions and guidelines
- DMCA Handling — Built-in copyright claim processing system
- Moderation Tools — Admin panel for content moderation and user management
- RESTful API — Full API access for third-party integrations
- API Keys — Generate personal API keys for programmatic access
- Danbooru Import — Import metadata and images from Danbooru
- Webhook Support — Receive notifications for uploads and interactions
A native Android app is available for mobile users:
- Download APK — Get the latest release
- Built with Kotlin & Jetpack Compose
- Material You design language
- Offline favorites support
- Push notifications
|
|
- Node.js 18+ or Bun 1.0+
- MongoDB 6.0+ (local or Atlas)
- Cloudflare R2 bucket (or compatible S3 storage)
- Serika Accounts instance for authentication
git clone https://github.com/serika-dev/Serika.art.git
cd Serika.art
npm install # or: bun installCreate .env.local with your credentials:
# Serika Accounts
ACCOUNTS_URL=https://accounts.serika.dev
ACCOUNTS_INTERNAL_KEY=your-internal-key
NEXT_PUBLIC_ACCOUNTS_URL=https://accounts.serika.dev
# MongoDB
MONGO_URI=mongodb://localhost:27017
MONGO_DB=serika-art
# Cloudflare R2
R2_ACCOUNT_ID=your-account-id
R2_ACCESS_KEY_ID=your-access-key
R2_SECRET_ACCESS_KEY=your-secret-key
R2_BUCKET_NAME=serika-art
R2_CUSTOM_DOMAIN=cdn.yourdomain.comnpm run dev # or: bun devOpen http://localhost:3000 🎉
serika.art/
├── app/ # Next.js App Router
│ ├── api/ # API routes
│ │ ├── images/ # Image CRUD operations
│ │ ├── upload/ # File upload handling
│ │ ├── tags/ # Tag management
│ │ ├── vote/ # Voting system
│ │ └── ...
│ ├── image/[id]/ # Image detail page
│ ├── artist/[tagName]/ # Artist portfolio page
│ ├── tags/ # Tag browser
│ ├── upload/ # Upload form
│ ├── admin/ # Admin dashboard
│ └── ...
│
├── components/ # React components
│ ├── ui/ # Shadcn/ui components
│ ├── Navbar.tsx # Navigation bar
│ ├── ImageCard.tsx # Image grid cards
│ └── ...
│
├── lib/ # Utilities & services
│ ├── db.ts # MongoDB connection
│ ├── r2.ts # Cloudflare R2 client
│ ├── auth.ts # Authentication helpers
│ └── models.ts # TypeScript interfaces
│
├── android/ # Native Android app
│ └── ... # Kotlin + Jetpack Compose
│
└── public/ # Static assets
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/images |
List images with pagination & filters |
GET |
/api/images/[id] |
Get single image details |
GET |
/api/tags |
Search and list tags |
GET |
/api/artists |
List artists |
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/upload |
Upload new image |
POST |
/api/vote |
Vote on an image |
POST |
/api/favorite |
Toggle favorite status |
GET |
/api/users/[id]/favorites |
Get user's favorites |
📖 Full API documentation available at serika.art/api-docs
- Click the button above or import from GitHub
- Configure environment variables
- Deploy!
# Build
npm run build
# Start production server
npm start
# Or with PM2
pm2 start npm --name "serika-art" -- startdocker build -t serika-art .
docker run -p 3000:3000 --env-file .env serika-artBackblaze B2 Upload Issues
If you encounter upload failures:
- Verify B2 application key ID and secret are correct
- Ensure bucket name and endpoint are properly configured
- Use Node.js 18+ for better TLS support
- Check firewall/VPN isn't blocking Backblaze
- Verify bucket CORS settings allow your domain
MongoDB Connection Issues
- Ensure MongoDB is running:
systemctl status mongod - Verify
MONGO_URIformat:mongodb://localhost:27017 - Check database user permissions if using authentication
Authentication Problems
- Verify Serika Accounts is accessible at
ACCOUNTS_URL - Ensure
ACCOUNTS_INTERNAL_KEYmatches your configuration - Clear browser cookies and try logging in again
While this project uses a source-available license that restricts commercial use, we welcome:
- 🐛 Bug reports and feature requests via Issues
- 📝 Documentation improvements
- 🌐 Translation contributions
Please read the LICENSE carefully before contributing.
Source Available License
This software is provided for viewing, educational, and personal use. You may:
- ✅ View and study the source code
- ✅ Fork for personal, non-commercial experimentation
- ✅ Deploy locally on your private network (not exposed to the internet)
- ✅ Submit bug reports and suggestions
You may NOT:
- ❌ Use this software for commercial purposes
- ❌ Deploy this software publicly on the internet
- ❌ Use tunneling services (ngrok, Cloudflare Tunnel, etc.) to expose it
- ❌ Redistribute or sublicense this software
- ❌ Create derivative works for distribution
See the full LICENSE file for complete terms.