BlockZen Documentation v1.0.0
Welcome to the official documentation for BlockZen — a modern, Web3-ready HTML template designed for DeFi platforms, crypto projects, and blockchain applications. This guide covers installation, folder structure, customization, and usage of all included components.
Tip
Use the sidebar to jump directly to the section you need.
Requirements
- A code editor (VS Code recommended)
- A local server — XAMPP, WAMP, or VS Code Live Server
- Modern browser (Chrome, Firefox, Edge)
Installation
Option 1 — Local Server (XAMPP)
- Place the
blockzen/folder insidehtdocs/. - Start Apache from the XAMPP Control Panel.
- Open
http://localhost/blockzen/main/home-1.htmlin your browser.
Option 2 — VS Code Live Server
- Open the project folder in VS Code.
- Right-click any HTML file → Open with Live Server.
Folder Structure
blockzen/
├── main/ ← Main HTML templates
│ ├── home-1.html ... home-5.html
│ └── assets/
│ ├── css/ ← bootstrap, style, responsive, animations
│ ├── js/ ← jquery, bootstrap bundle, main.js
│ ├── images/
│ ├── fonts/
│ └── vendor/ ← swiper, aos, chartjs
└── documentation/ ← This documentation
├── index.html
├── css/
├── js/
└── assets/
Home Pages
| File | Description |
|---|---|
home-1.html |
Dark hero — DeFi landing |
home-2.html |
Gradient hero — NFT / Token |
home-3.html |
Split-screen — Web3 SaaS |
home-4.html |
Minimal — Crypto Exchange |
home-5.html |
Dashboard style — Portfolio |
CSS Files
| File | Purpose |
|---|---|
bootstrap.min.css |
Bootstrap 5.3 grid & utilities |
style.css |
Core custom styles & CSS variables |
responsive.css |
Media queries for all breakpoints |
animations.css |
Keyframes & animation utility classes |
Override CSS variables in style.css under :root { } to change the global color scheme
without touching any other file.
JavaScript Files
| File | Purpose |
|---|---|
jquery.min.js |
jQuery 3.7.1 |
bootstrap.bundle.min.js |
Bootstrap 5.3 + Popper |
main.js |
Custom scripts — nav, counters, AOS init, Swiper init, back-to-top |
Add your page-specific scripts inside js/plugins/ and link them before </body>.
Vendor Libraries
| Library | Version | Location |
|---|---|---|
| AOS (Animate on Scroll) | 2.3.4 | vendor/aos/ |
| Swiper | 11 | vendor/swiper/ |
| Chart.js | 4.4.3 | vendor/chartjs/ |
Colors & Typography
All colors are defined as CSS custom properties. Edit main/assets/css/style.css:
:root {
--primary-color: #6c63ff; /* Purple accent */
--secondary-color: #00d4aa; /* Teal accent */
--dark-bg: #0d0d1a; /* Page background */
--dark-card: #13132b; /* Card background */
--text-light: #ffffff;
--text-muted: #a0a0c0;
}
Changelog
v1.0.0 — 2026
- Initial release with 5 home page variants
- AOS, Swiper, Chart.js vendor integrations
- Full documentation
Credits
| Resource | License |
|---|---|
| Bootstrap 5 | MIT |
| jQuery | MIT |
| AOS | MIT |
| Swiper | MIT |
| Chart.js | MIT |
| Bootstrap Icons | MIT |
| Font Awesome 6 | CC BY 4.0 |
| Google Fonts | OFL |