v0.0.3

v0.0.3 - LokiJS Database & Project Setup Wizard

🎉 Major Features

LokiJS Database Integration

• Replaced .env file storage with embedded LokiJS database
• Session management with 24-hour TTL
• Secure password storage with bcrypt hashing
• Project cache with 5-minute TTL
• Audit logging with 30-day retention

Project Setup Wizard

• 4-step configuration wizard for new projects
• Project configuration (name, environment, region)
• Database setup (PostgreSQL configuration)
• Service selection (choose which services to include)
• Review and build with real-time progress

Improved Authentication Flow

• Database-backed sessions instead of environment variables
• CSRF protection for all state-changing requests
• Automatic session expiration and cleanup
• Development vs production password requirements

🚨 Breaking Changes

• Database Migration Required: Previous .env-based authentication replaced with LokiJS
• Password Reset Required: Users upgrading from v0.0.2 must set a new password
• Volume Mount Required: New volume needed for /app/data persistence
• Session Format Changed: New session token format incompatible with v0.0.2

🔧 Technical Improvements

• Zero TypeScript errors in production build
• Fixed all ESLint issues
• Optimized component rendering with useMemo hooks
• Better error handling for directory creation
• Improved health endpoint with version reporting
• Fixed Button component variant issues
• Full-screen pages for Login, Build, and Start flows

📚 Documentation

• Complete architecture documentation
• API reference for authentication endpoints
• Installation and quick start guides
• Docker deployment documentation
• First-time setup walkthrough
• Security best practices

🐛 Bug Fixes

• Docker image download progress not showing during service startup
• Edge Runtime compatibility issues with middleware
• WebSocket connection errors on initial load
• 401 authentication errors before checking if user is logged in
• Metadata viewport warnings in console
• Password persistence issues after container restart

📦 Installation

Docker (Recommended)

docker run -d
-p 3021:3021
-v /path/to/project:/workspace:rw
-v nself-admin-data:/app/data
--name nself-admin
acamarata/nself-admin:0.0.3

Local Development

git clone https://github.com/acamarata/nself-admin.git
cd nself-admin
npm install
npm run dev

🔄 Upgrade Notes

If upgrading from v0.0.2:

1. Stop and remove the old container
2. Start new container with volume mount for /app/data
3. Set a new admin password on first login
4. Your project configurations will need to be re-entered

📝 License

Dual licensed for free personal use and commercial licensing. See LICENSE file for details.

🙏 Support

• Issues: https://github.com/acamarata/nself-admin/issues
• Telegram: @nselforg
• Commercial Support: https://nself.org/commercial

---

Note: This is an alpha release (v0.0.x). Breaking changes may occur in future releases. Not recommended for production use
without thorough testing.