Code Storage Website

A comprehensive web application for storing, viewing, categorizing, and executing code files. This platform supports multiple programming languages and allows you to run HTML websites within the application.

🎉 Now with TypeScript and React support! The project includes a modern frontend built with TypeScript and React. See TYPESCRIPT_REACT_SETUP.md for details.

🤖 NEW: AI-Powered C/C++ Code Analysis! The platform now includes intelligent code analysis for C and C++ with security checks, best practices, and alternative implementations. See ENHANCED_COMPILER_README.md for details.

Features

📁 Code Storage & Organization

Upload and store code files organized by language
Support for Python, Java, C, C++, and HTML
Add titles and descriptions to your code files
Automatic categorization by programming language

👁️ Code Viewing

Syntax-highlighted code editor (powered by CodeMirror)
Beautiful, modern UI with dark theme editor
View all your stored codes in organized categories

▶️ Code Execution

Execute Python, Java, C, and C++ code directly in the browser
Provide custom input (stdin) for interactive programs
View program output and error messages in real-time
Sandboxed execution with timeout limits for security
Enhanced C/C++ compiler with multiple standards support (C11, C++17, etc.)
Better error messages with helpful hints

🤖 AI Code Analysis (C/C++)

Intelligent static code analysis for C and C++ code
Security vulnerability detection (buffer overflows, format strings, etc.)
Memory leak detection and resource management suggestions
Best practices recommendations (const correctness, modern C++ features)
Alternative implementation suggestions (vectors vs arrays, smart pointers, etc.)
Complete refactored code examples - ChatGPT-style comprehensive code transformations
🎯 Full refactored version combining all improvements into working code
Code quality improvements (magic numbers, uninitialized variables)
Real-time analysis with detailed, actionable feedback
🚀 One-click GitHub PR creation with refactored code
See ENHANCED_COMPILER_README.md for full documentation

🌐 HTML Website Preview

Upload complete HTML websites
View HTML code with syntax highlighting
Live preview of HTML websites running inside the platform
Fullscreen mode for better viewing experience
Copy code to clipboard
Refresh preview on demand

🔐 Encrypted Code Storage

Server-side encrypted Python code examples
Hybrid RSA-4096 + AES-256-GCM encryption
Token-based authentication with HMAC-SHA256
View encrypted code files through secure web interface
Code is decrypted server-side only (private key never exposed)
Time-limited access tokens for enhanced security

📤 Multi-File Upload

Upload single files or multiple files at once
Support for folder/batch uploads
Automatic file organization by language
File preview before upload
Drag-and-drop support (coming soon)

☁️ Vercel Blob Storage Integration

Persistent file storage for serverless deployments
Automatic file synchronization to Vercel Blob
Files persist across deployments on Vercel
Graceful fallback to local storage
Works alongside GitHub integration
See VERCEL_BLOB_SETUP.md for setup guide

📝 Notes with Screenshots

Create and store notes with rich text content
Attach multiple screenshots/images to notes
Server-side storage with Vercel KV (Redis-compatible database)
Drag-and-drop image upload support
Image gallery with thumbnail previews
Edit and delete notes
Fallback to local memory if KV not configured
Accessible from any code view page via "📝 Notes" button
See VERCEL_KV_SETUP.md for setup guide
Perfect for documentation, reminders, and visual references

Supported Languages

Language	Extension	Execution Support	Compilation	AI Analysis
Python	`.py`	✅ Yes	No	⏳ Coming Soon
Java	`.java`	✅ Yes	Yes (javac)	⏳ Coming Soon
C	`.c`	✅ Yes	Yes (gcc/clang)	✅ Yes
C++	`.cpp`	✅ Yes	Yes (g++/clang++)	✅ Yes
HTML	`.html`	🌐 Live Preview	N/A	N/A

GitHub Pages Deployment

🌐 Live Demo

Visit the live demo at: https://shield44-project.github.io/codes_storer_website/

The GitHub Pages deployment includes:

A landing page explaining the project and features
The encrypted file viewer (viewer.html) as a standalone static page

⚠️ Important Limitations

This is primarily a Flask application that requires a Python backend server. GitHub Pages only supports static HTML/CSS/JavaScript files and cannot run the full application with the following features:

Code execution (Python, Java, C, C++)
Code storage and upload
File management

To use these features, you must run the application locally (see installation instructions below).

What Works on GitHub Pages

✅ Project landing page with documentation
✅ Encrypted file viewer (requires separate decryption server)
✅ Static content and documentation

Installation (Local Deployment)

Prerequisites

Python 3.8 or higher
For code execution support, install:
- Python 3 (for Python code execution)
- Java JDK (for Java code execution)
- GCC (for C code execution)
- G++ (for C++ code execution)

Setup Instructions

Clone the repository:

git clone https://github.com/shield44-project/codes_storer_website.git
cd codes_storer_website

Install Python dependencies:

pip install -r requirements.txt

Run the Flask application:

python app.py

Open your browser and navigate to:

http://localhost:5000

Running with Virtual Environment (Recommended)

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Configuration

The application can be configured using environment variables:

Storage Configuration

CODES_DIRECTORY (optional)

Directory for storing code files
Default: stored_codes
Example: /tmp/stored_codes (for serverless platforms)

shield44_READ_WRITE_TOKEN (optional, recommended for Vercel)

Vercel Blob Storage read-write token for persistent storage
Enables file persistence on serverless platforms
See VERCEL_BLOB_SETUP.md for setup
Example: vercel_blob_rw_GmsSyO1ENI6nA5GJ_ETd7tIhY7RialiPNyz5YaP8U2EZTAZ

GitHub Integration (optional)

GITHUB_TOKEN

GitHub Personal Access Token for automatic commits
Requires repo scope
See GITHUB_INTEGRATION_SETUP.md

GITHUB_REPO

Target repository for commits
Default: shield44-project/pastebins

GITHUB_BRANCH

Target branch for commits
Default: main

Flask Configuration

FLASK_DEBUG

Enable debug mode (True/False)
Default: False (production)

FLASK_HOST

Server host
Default: 0.0.0.0

FLASK_PORT

Server port
Default: 5000

Usage Guide

Uploading Code

Single File Upload (Paste Code):

Click on "Upload New Code" button on the home page
Select the "📝 Paste Code" tab
Select the language (Python, Java, C, C++, or HTML)
Enter a title for your code
Optionally add a description
Paste your code in the code editor
Click "Upload Code"

Multiple File Upload:

Click on "Upload New Code" button on the home page
Select the "📁 Upload Files" tab
Select the language
Click "Select Files" and choose one or more files
Preview the selected files
Click "Upload Files"

Viewing Encrypted Python Code Examples

The repository includes encrypted Python code examples that can be viewed securely:

Setup (First Time Only):
- Place your private_key.pem in the root directory OR
- Run python setup_encryption.py for guided setup
- See SETUP_ENCRYPTION.md for detailed instructions
Viewing Files:
- Navigate to /encrypted-viewer on the running Flask app
- Click on any Python file from the list
- Files are automatically decrypted and displayed (no manual token entry needed!)

Note: The system uses "shield44" as the default token secret for generating access tokens. The private key (private_key.pem) must be present for decryption to work. See SETUP_ENCRYPTION.md for more details.

Viewing and Executing Code

For Programming Languages (Python, Java, C, C++):

Navigate to a language category from the home page
Click on a code file to view it
Click "▶️ Run Code" to execute the code
Optionally provide input in the "Input (stdin)" field
View the output in the output panel

For HTML Websites:

Navigate to the HTML category
Click on an HTML file to view it
The left panel shows the HTML code
The right panel shows a live preview of the website running
Use the "🔄 Refresh" button to reload the preview
Use the "⛶ Fullscreen" button to view the website in fullscreen mode
Use the "📋 Copy Code" button to copy the HTML code

Category Management

All uploaded files are automatically organized by language:

Python files → Python category
Java files → Java category
C files → C category
C++ files → C++ category
HTML files → HTML category

Project Structure

codes_storer_website/
├── app.py                  # Main Flask application (with encryption support)
├── config.py              # Configuration settings
├── encrypt_files.py       # Tool for encrypting Python files
├── decrypt_server.py      # Standalone decryption server
├── generate_keys.py       # RSA key generation tool
├── token_gen.py           # Access token generation tool
├── requirements.txt       # Python dependencies
├── README.md              # This file
├── ENCRYPTION_README.md   # Encryption documentation
├── .gitignore            # Git ignore rules
├── public_key.pem        # RSA public key (committed)
├── private_key.pem       # RSA private key (NOT committed, server-only)
├── viewer.html           # Encrypted file viewer (standalone page)
├── templates/            # HTML templates
│   ├── base.html         # Base template
│   ├── index.html        # Home page
│   ├── category.html     # Category listing page
│   ├── upload.html       # Upload form (with multi-file support)
│   ├── view_code.html    # Code viewer for executable languages
│   └── view_html.html    # HTML website viewer with live preview
├── static/               # Static assets
│   └── css/
│       └── style.css     # Stylesheet
├── encrypted/            # Encrypted Python code examples (committed)
│   ├── manifest.json     # Index of encrypted files
│   └── *.py.enc.json    # Encrypted Python files
└── stored_codes/         # Storage directory (auto-created, not committed)
    ├── python/           # Python files
    ├── java/             # Java files
    ├── c/                # C files
    ├── cpp/              # C++ files
    ├── html/             # HTML files
    └── *_metadata.json   # Metadata files

Security Features

Code Execution Security

Code execution is sandboxed with 5-second timeout limits
Temporary directory usage for compilation and execution
Input sanitization for uploaded code
HTML preview uses iframe with sandbox attributes
No direct file system access from executed code
Command injection prevention with shell=False

Encrypted Code Storage

Hybrid RSA-4096 + AES-256-GCM encryption for Python code examples
Server-side decryption only - private key never exposed to clients
Token-based authentication with HMAC-SHA256 signatures
Time-limited access tokens (default 1 hour, configurable)
Encrypted files stored in repository, safe to commit
Private key must be kept secure on server (excluded from git)
See ENCRYPTION_README.md for detailed documentation

File Upload Security

File size limits (16MB max)
File extension validation
Filename sanitization to prevent path traversal
Content-type validation

Technologies Used

Backend

Flask: Python web framework
Python 3: Core backend language
Cryptography: RSA-OAEP, AES-GCM encryption
HMAC-SHA256: Token-based authentication

Frontend

TypeScript: Type-safe JavaScript development
React: Component-based UI framework
Webpack: Module bundler and build tool
HTML5, CSS3: Modern web standards
JavaScript (ES6+): Modern JavaScript features

Development Tools

Node.js & npm: Package management
ts-loader: TypeScript compilation for Webpack
CodeMirror: Syntax highlighting

Code Execution

subprocess: Python code execution
Compilers: javac (Java), gcc (C), g++ (C++)

Frontend Development

This project now includes a modern TypeScript/React frontend. For detailed information about the frontend setup, see TYPESCRIPT_REACT_SETUP.md.

Quick Start (Frontend)

# Install dependencies
npm install

# Start development server
npm start

# Build for production
npm run build

The React app runs on http://localhost:3000 during development, while the Flask backend runs on http://localhost:5000.

Browser Compatibility

Chrome/Edge (recommended)
Firefox
Safari
Opera

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Troubleshooting

Code execution not working?

Ensure the required compiler/interpreter is installed
Check that the PATH environment variable includes the compiler/interpreter

HTML preview not showing?

Check browser console for errors
Ensure the HTML file is valid
Try the refresh button

Upload failing?

Check that the code syntax is valid
Ensure title doesn't contain special characters
Verify the file extension matches the selected language

AI Analysis not showing results?

Ensure you're viewing a C or C++ file
Check browser console for errors
Try refreshing the page
See ENHANCED_COMPILER_README.md for troubleshooting

Enhanced compiler errors?

Install required compilers: sudo apt-get install gcc g++ clang
System will automatically fall back to online compilation
Check ENHANCED_COMPILER_README.md for details

Future Enhancements

✅ AI Code Analysis for C/C++ (Completed!)
✅ Enhanced C/C++ Compiler with Multiple Standards (Completed!)
AI Code Analysis for Python, Java, and other languages
Support for more languages (JavaScript, Ruby, Go, Rust, etc.)
Machine learning-based bug prediction
Collaborative code editing
Code sharing via links
Syntax checking before upload
Code version history
Search functionality
Code comments and annotations
Real-time code analysis as you type
Integration with popular IDEs (VS Code, Vim, etc.)

Support

For issues, questions, or suggestions, please open an issue on GitHub.

Name		Name	Last commit message	Last commit date
Latest commit History 169 Commits
.github/workflows		.github/workflows
compiler-backend		compiler-backend
docs/screenshots		docs/screenshots
frontend-vercel		frontend-vercel
src		src
static		static
stored_codes		stored_codes
templates		templates
.gitignore		.gitignore
CODE_RUNNER_README.md		CODE_RUNNER_README.md
DEPLOYMENT.md		DEPLOYMENT.md
ENCRYPTION_README.md		ENCRYPTION_README.md
ENHANCED_COMPILER_README.md		ENHANCED_COMPILER_README.md
FEATURE_IMPLEMENTATION.md		FEATURE_IMPLEMENTATION.md
FEATURE_SUMMARY.md		FEATURE_SUMMARY.md
GITHUB_INTEGRATION_SETUP.md		GITHUB_INTEGRATION_SETUP.md
IMPLEMENTATION_SUMMARY.md		IMPLEMENTATION_SUMMARY.md
PROJECT_SUMMARY.txt		PROJECT_SUMMARY.txt
QUICKSTART.md		QUICKSTART.md
README.md		README.md
SETUP_ENCRYPTION.md		SETUP_ENCRYPTION.md
TESTING_REPORT.md		TESTING_REPORT.md
TYPESCRIPT_REACT_SETUP.md		TYPESCRIPT_REACT_SETUP.md
VERCEL_BLOB_SETUP.md		VERCEL_BLOB_SETUP.md
VERCEL_DEPLOYMENT.md		VERCEL_DEPLOYMENT.md
VERCEL_KV_SETUP.md		VERCEL_KV_SETUP.md
_codeql_detected_source_root		_codeql_detected_source_root
app.py		app.py
blob_storage.py		blob_storage.py
build.sh		build.sh
code_analyzer.py		code_analyzer.py
config.py		config.py
decrypt_server.py		decrypt_server.py
demo_code_with_issues.c		demo_code_with_issues.c
demo_enhanced_features.py		demo_enhanced_features.py
encrypt_files.py		encrypt_files.py
enhanced_compiler.py		enhanced_compiler.py
generate_keys.py		generate_keys.py
generate_static_data.py		generate_static_data.py
index.html		index.html
migrate_code_files.py		migrate_code_files.py
netlify.toml		netlify.toml
notes_storage.py		notes_storage.py
package.json		package.json
public_key.pem		public_key.pem
regenerate_metadata.py		regenerate_metadata.py
requirements.txt		requirements.txt
runtime.txt		runtime.txt
setup_encryption.py		setup_encryption.py
test_blob_storage.py		test_blob_storage.py
test_category_display.py		test_category_display.py
test_delete.py		test_delete.py
test_end_to_end.py		test_end_to_end.py
test_enhanced_compiler.py		test_enhanced_compiler.py
test_fixes.py		test_fixes.py
test_manual_verification.py		test_manual_verification.py
test_online_compilers.py		test_online_compilers.py
test_upload_error_handling.py		test_upload_error_handling.py
token_gen.py		token_gen.py
tsconfig.json		tsconfig.json
upload_standalone.html		upload_standalone.html
vercel.json		vercel.json
viewer.html		viewer.html
webpack.config.js		webpack.config.js
webpack.prod.config.js		webpack.prod.config.js

shield44-project/pastebins

Folders and files

Latest commit

History

Repository files navigation