A Simple Content Management System - SimpleCms

lufy

October 09, 2025

<h1>SimpleCMS - File Management System</h1><br><br><a href="https://github.com/lufy90/SimpleCms.git">Source code</a><br><br>A comprehensive Content Management System built with Django and Vue.js that can manage any kind of file on your disk.<br><br><h2>Features</h2><br><ul><li><strong>File System Management</strong>: Browse, upload, download, and manage files and directories</li><li><strong>Access Control</strong>: Public/private file visibility and user ownership</li><li><strong>File Operations</strong>: Copy, move, delete, and rename files</li><li><strong>Office integratable</strong>: Can integrate onlyoffice document-server</li><li><strong>Access Logging</strong>: Track file access, downloads, and modifications</li><li><strong>RESTful API</strong>: Full API for frontend integration</li><li><strong>Admin Interface</strong>: Django admin for system management</li><li><b>Preview:</b> Here are some screenshots of the SimpleCMS interface:</li><br>File List View!<a href="/media/files/2025/10/09/preview01_list.png">preview01_list.png</a><br>Picture Gallery View!<a href="/media/files/2025/10/09/preview02_pictures.png">preview02_pictures.png</a><br>Text File Editor!<a href="/media/files/2025/10/09/preview03_text.png">preview03_text.png</a><br>Office File Editor (need onlyoffice document-server)!<a href="/media/files/2025/10/09/preview04_word.png">preview04_word.png</a></ul><span style="font-size: 2rem;">Quick Start</span><br><span style="font-size: 1.75rem;">Prerequisites</span><br><ul><li>Python 3.8+- Node.js 20.19.0+ (for frontend and electron)</li><li>Virtual environment- Django 5.2+</li></ul><h3>Backend Setup</h3>1. <strong>Activate virtual environment</strong>:<br>   ```bash<br>   source venv/bin/activate<br>   ```<br>2. <strong>Install dependencies</strong>:<br>   ```bash<br>   cd backend<br>   pip install -r requirements.txt<br>   ```<br>3. <strong>Run migrations</strong>:<br>   ```bash<br>   python manage.py makemigrations<br>   python manage.py migrate<br>   ```<br><br>4. <strong>Create superuser</strong>:<br>   ```bash<br>   python manage.py createsuperuser<br>   ```<br><br>5. <strong>Run development server</strong>:<br>   ```bash<br>   python manage.py runserver localhost:8000<br>   ```<br><br><h3>Frontend</h3>1. <strong>Build web application</strong>:<br>   ```bash<br>   cd frontend &amp;&amp; npm install<br>   VITE_API_BASE_URL=http://localhost:8000 npm run dev <br>   ```<br>2. <strong>Build electron application</strong> (optional):<br>   ```bash<br>   cd electron &amp;&amp; npm install<br>   VITE_API_BASE_URL=http://localhost:8000 npm run build<br>   ```<br><h2>Build and Deployment</h2>For detailed production deployment instructions, please refer to the <a href="docs/deployment.md">Deployment Guide</a>.<br><h2>Usage Examples</h2><h3>List all files</h3>```bash<br>curl -X GET "http://localhost:8000/api/files/" \<br>  -H "Authorization: Basic $(echo -n 'admin:password' | base64)"<br>```<br><h3>Search for files</h3><br>```bash<br>curl -X GET "http://localhost:8000/api/files/search/?q=document" \<br>  -H "Authorization: Basic $(echo -n 'admin:password' | base64)"<br>```<br><h3>Get directory tree</h3>```bash<br>curl -X GET "http://localhost:8000/api/files/tree/?root=/home/username" \<br>  -H "Authorization: Basic $(echo -n 'admin:password' | base64)"<br>```<br>#<h3>Upload a file</h3>```bash<br>curl -X POST "http://localhost:8000/api/upload/" \<br>  -H "Authorization: Basic $(echo -n 'admin:password' | base64)" \<br>  -F "file=@/path/to/local/file.txt" \<br>  -F "destination_path=/home/username/uploads" \<br>  -F "tags=work,important" \<br>  -F "is_public=false"<br>```<br><h2>Configuration</h2><h3>Django Settings</h3>The main settings are in `backend/backend/settings.py`:<br><ul><ul>- <strong>CORS</strong>: Configured for Vue.js frontend- <strong>File Upload</strong>: 100MB maximum file size- <strong>Media Files</strong>: Served from `/media/` directory- <strong>REST Framework</strong>: Pagination, authentication, and permissions<br></ul></ul>