The easiest way to run SecStore - Production-ready in under 60 seconds:

# Clone repository
git clone https://github.com/madcoda9000/SecStore.git
cd SecStore

# Configure environment (optional - adjust database passwords)
cp .env.example .env

# Start containers
docker-compose up -d

# Open browser
http://localhost:8000

🎉 Done! Follow the web-based setup wizard to configure your database and admin account.

What you get:

• ✅ PHP 8.3 with all required extensions
• ✅ MySQL 8.0 database
• ✅ phpMyAdmin for database management
• ✅ Persistent storage for config, cache, and logs
• ✅ Automatic setup with one command

Full Docker documentation: 📖 README_DOCKER.md

For custom environments or when Docker is not available:

# Clone repository
git clone https://github.com/madcoda9000/SecStore.git
cd SecStore

# Run automatic setup script
chmod +x secstore_setup.sh && ./secstore_setup.sh

# Configure application
cp config.php_TEMPLATE config.php
# -> Edit config.php with your database credentials

# Start development server
php -S localhost:8000 -t public

🎉 Done! SecStore is running at http://localhost:8000

Default Login: super.admin / Test1000! (⚠️ Change password immediately!)

For detailed manual installation: 📖 INSTALL.md

SecStore is designed as a boilerplate for building custom web applications with modern security features built-in.

• 🔧 Development environment setup
• 📄 Creating Latte templates and controllers
• 🛣️ Adding routes and navigation
• 💾 JavaScript integration (CSP-compliant)
• 🌍 Multilingual support implementation

🔑 Login & Authentication

👤 User Dashboard & Profile

🖼️ Show more screenshots

Admin Area	Security Dashboard

Rate Limiting	Audit Logs

Settings	Registration

Backend
Frontend
Database
Security
Tools

🐳 Using Docker? Skip these requirements! Docker handles everything automatically.
See README_DOCKER.md for Docker installation.

For manual installation:

SecStore follows a Model-View-Controller (MVC) architecture with additional middleware and utility layers for enhanced security.

SecStore/
├── 📁 app/                    # Core Application
│   ├── Controllers/           # MVC Controllers
│   ├── Models/               # Data Models (Paris ORM)
│   ├── Utils/                # Helper Classes (Session, Log, Security, etc.)
│   ├── Middleware/           # Request Middleware (CSRF, Auth, Rate Limiting)
│   ├── views/                # Latte Templates
│   └── lang/                 # Translations (DE/EN)
├── 📁 public/                # Web Root (Entry Point)
│   ├── index.php            # Application Bootstrap
│   ├── css/                  # Stylesheets
│   └── js/                   # JavaScript Files
├── 📁 Documentation/         # Project Documentation
│   ├── ARCHITECTURE.md      # Complete architecture documentation
│   ├── INSTALL.md           # Installation Guide
│   ├── DEVDOC.md            # Developer Guide
│   ├── SECURITY.md          # Security Policy
│   └── CHANGELOG.md         # Version History
├── 📁 database/              # Database Schema Files
├── 📁 tests/                 # PHPUnit Tests (Unit & Integration)
├── 📁 cache/                 # Template Cache
├── config.php               # Main Configuration
└── composer.json            # Dependencies

• MVC Pattern - Clean separation of concerns
• Middleware Stack - Rate Limiting → CSRF → Authentication → Authorization
• Security-First - Session fingerprinting, CSRF tokens, input validation
• Extensible - Easy to add custom controllers, models, and utilities
• CSP-Compliant - No inline scripts or styles

📖 For complete architecture details, request lifecycle, and extension guide:
👉 ARCHITECTURE.md

SecStore is designed as a boilerplate for building custom web applications with modern security features built-in.

# Install dependencies with dev tools
composer install

# Install Git hooks for code quality
./setup-hooks.sh

# Start development server
php -S localhost:8000 -t public

Everything you need to extend SecStore:

👉 DEVDOC.md - Complete step-by-step developer documentation

What's inside:

• 🔧 Development environment setup & tools
• 📄 Creating custom pages, controllers, and models
• 🛣️ Adding routes and navigation
• 💾 CSP-compliant JavaScript integration
• 🌍 Multilingual support implementation
• 🧪 Testing strategies and best practices
• 📚 Code quality guidelines and Git workflow

We welcome contributions! 🎉

1. Fork the repository
2. Create a feature branch
3. Follow the guidelines in DEVDOC.md
4. Open a Pull Request

Coding Standards:

• ✅ PSR-12 compliant PHP code
• ✅ Conventional Commits (use ./quick-commit.sh)
• ✅ Tests for new features
• ✅ Update documentation

If you like SecStore, give us a ⭐ on GitHub! This motivates us to continue working on the project.