Skip to content

Commit ab998e9

Browse files
PromastergamePromastergame
committed
Initial clean commit
0 parents  commit ab998e9

111 files changed

Lines changed: 17678 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/main.yml‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
name: Deploy site
2+
3+
on:
4+
push:
5+
branches: [ "main" ]
6+
7+
jobs:
8+
build:
9+
runs-on: ubuntu-latest
10+
steps:
11+
- uses: actions/checkout@v3
12+
13+
- name: Set up Node
14+
uses: actions/setup-node@v3
15+
with:
16+
node-version: 18
17+
18+
- name: Install deps
19+
run: npm ci
20+
21+
- name: Build
22+
run: npm run build
23+
24+
- name: Create 404.html for SPA
25+
run: cp dist/index.html dist/404.html
26+
27+
- name: Upload artifact
28+
uses: actions/upload-pages-artifact@v3
29+
with:
30+
path: dist
31+
32+
deploy:
33+
needs: build
34+
runs-on: ubuntu-latest
35+
permissions:
36+
pages: write
37+
id-token: write
38+
environment:
39+
name: github-pages
40+
url: ${{ steps.deployment.outputs.page_url }}
41+
steps:
42+
- name: Deploy to GitHub Pages
43+
id: deployment
44+
uses: actions/deploy-pages@v4

‎.gitignore‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Logs
2+
logs
3+
*.log
4+
npm-debug.log*
5+
yarn-debug.log*
6+
yarn-error.log*
7+
pnpm-debug.log*
8+
lerna-debug.log*
9+
10+
node_modules
11+
dist
12+
dist-ssr
13+
*.local
14+
15+
# Editor directories and files
16+
.vscode/*
17+
!.vscode/extensions.json
18+
.idea
19+
.DS_Store
20+
*.suo
21+
*.ntvs*
22+
*.njsproj
23+
*.sln
24+
*.sw?
25+
yandex_9a44356d29ab9cb7.html
26+
dist

‎LICENSE‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
Copyright (c) 2025 Promaster Development
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy
4+
of this software and associated documentation files (the “Software”), to deal
5+
in the Software without restriction, including without limitation the rights
6+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7+
copies of the Software, subject to the following conditions:
8+
9+
1. Attribution.
10+
Any use, distribution, modification or publication of the Software must
11+
include a clearly visible notice:
12+
“Developed by Promaster Development”.
13+
It is prohibited to remove or replace the original authorship without
14+
explicit permission from the author.
15+
16+
2. Safe Use Only.
17+
The Software may not be used to create malware, viruses, harmful scripts,
18+
exploits, offensive security tools, or to train users in performing
19+
real-world harmful attacks.
20+
21+
3. Allowed Educational Use.
22+
The Software may be used for educational purposes related to cybersecurity,
23+
including:
24+
– teaching SQLi, XSS, CSRF prevention;
25+
– demonstrating vulnerabilities in safe or simulated environments;
26+
– using pseudo-malicious logic that cannot cause real damage.
27+
28+
4. Restricted Offensive Training.
29+
Teaching real offensive techniques, malware development, or exploitation
30+
of vulnerabilities outside a controlled safe environment is prohibited.
31+
Such use requires explicit permission from the author.
32+
33+
5. Safety Representation.
34+
The Software must be presented as safe, educational and non-malicious.
35+
It is prohibited to label it as “unofficial OWASP” or otherwise misrepresent
36+
its purpose.
37+
38+
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39+
IMPLIED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR
40+
OTHER LIABILITY ARISING FROM OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.

‎LICENSE-RU‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
Копирайт (c) 2025 Promaster Development
2+
3+
Настоящим бесплатно предоставляется разрешение любому лицу, получившему копию
4+
данного программного обеспечения и сопутствующей документации (далее —
5+
«Программное обеспечение»), использовать Программное обеспечение без
6+
ограничений, включая без ограничения права использовать, копировать, изменять,
7+
объединять, публиковать, распространять, предоставлять сублицензии и/или
8+
продавать копии Программного обеспечения при соблюдении следующих условий:
9+
10+
1. Указание автора.
11+
Любое использование, распространение, модификация или публикация
12+
Программного обеспечения должно сопровождаться явно видимым уведомлением:
13+
«Developed by Promaster Development».
14+
Запрещается удалять или заменять оригинальное указание авторства без
15+
явного разрешения автора.
16+
17+
2. Использование только в безопасных целях.
18+
Программное обеспечение не может использоваться для создания вредоносного
19+
ПО, вирусов, вредоносных скриптов, эксплойтов, наступательных инструментов
20+
безопасности или для обучения реальным вредоносным атакам в реальной среде.
21+
22+
3. Разрешённое образовательное использование.
23+
Программное обеспечение может использоваться в образовательных целях,
24+
связанных с кибербезопасностью, включая:
25+
– обучение предотвращению SQLi, XSS, CSRF;
26+
– демонстрацию уязвимостей в безопасных или симулированных средах;
27+
– работу с псевдовредоносной логикой, не способной нанести реальный ущерб.
28+
29+
4. Ограничение атакующего обучения.
30+
Обучение реальным наступательным техникам, разработке вредоносного ПО или
31+
эксплуатации уязвимостей вне контролируемой безопасной среды запрещено.
32+
Такое использование требует явного разрешения автора.
33+
34+
5. Корректное позиционирование.
35+
Программное обеспечение должно представляться как безопасное,
36+
образовательное и ненаносительное вреда. Запрещено называть его
37+
«неофициальным OWASP» или вводить пользователей в заблуждение относительно
38+
его назначения.
39+
40+
ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ,
41+
ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ. АВТОР НИ В КАКОМ СЛУЧАЕ НЕ НЕСЁТ ОТВЕТСТВЕННОСТИ
42+
ЗА КАКИЕ-ЛИБО ПРЕТЕНЗИИ, УЩЕРБ ИЛИ ИНУЮ ОТВЕТСТВЕННОСТЬ, ВОЗНИКШИЕ В СВЯЗИ
43+
С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ЕГО ИСПОЛЬЗОВАНИЕМ.

‎README-EN.md‎

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
📘 WebSec Academy
2+
3+
Interactive Web Security Learning Platform
4+
Developed by Promaster Development
5+
6+
📖 About the Project
7+
8+
WebSec Academy is an interactive learning platform designed to teach web development basics, web security fundamentals, and how common vulnerabilities work — all in a clear, safe, and beginner-friendly format.
9+
10+
The platform focuses on defensive learning, simulated environments, and accessible explanations — without any harmful or dangerous tools.
11+
12+
🚀 Features
13+
14+
🎓 Simple, intuitive theoretical modules
15+
16+
🧪 Safe interactive simulations
17+
18+
🧠 Knowledge quizzes
19+
20+
💡 Practical defensive examples
21+
22+
🌗 Dark & Light themes
23+
24+
⚡ Modern frontend stack
25+
26+
🔒 Absolutely safe — no real attacks
27+
28+
🛠️ Tech Stack
29+
30+
Frontend: React, TypeScript, Vite
31+
UI: TailwindCSS, shadcn/ui, Framer Motion
32+
Icons: Lucide React
33+
State Management: useState, custom hooks
34+
Design: minimalistic, smooth animations
35+
36+
📦 Installation & Running
37+
# Clone the repository
38+
git clone https://github.com/Promastergame/WebSecAcademy.git
39+
cd websec-academy-main
40+
41+
# Install dependencies
42+
npm install
43+
44+
# Start development server
45+
npm run dev
46+
47+
👨‍💻 Author
48+
49+
Promaster Development
50+
Developer creating websites, games, and Telegram bots.
51+
Exploring cybersecurity and modern web technologies.
52+
53+
📫 Telegram: https://t.me/Promaster_Developer
54+
55+
🌐 GitHub: https://github.com/Promastergame
56+
57+
📜 License
58+
59+
This project is distributed under the custom
60+
WMIT-Safe License (MIT + Safe Use Rules).
61+
62+
You must always include the attribution:
63+
64+
“Developed by Promaster Development”
65+
66+
Full license text:
67+
68+
LICENSE (English)
69+
70+
LICENSE-RU (Russian)
71+
72+
⚠️ Safety Notice
73+
74+
WebSec Academy is designed solely for educational and defensive cybersecurity purposes.
75+
76+
Allowed:
77+
78+
learning how vulnerabilities work in a safe environment
79+
80+
studying defensive techniques (SQLi prevention, XSS mitigation, etc.)
81+
82+
using simulated or pseudo-vulnerabilities
83+
84+
Not allowed:
85+
86+
developing malware
87+
88+
performing harmful attacks
89+
90+
offensive security training without explicit permission
91+
92+
misrepresenting the project
93+
(e.g., calling it “unofficial OWASP”)
94+
95+
This platform is intended to be safe, ethical, and educational.

‎README.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
📘 WebSec Academy
2+
3+
Интерактивная обучающая платформа по веб-безопасности
4+
Developed by Promaster Development
5+
6+
📖 О проекте
7+
8+
WebSec Academy — это интерактивная учебная платформа, созданная для изучения веб-разработки, принципов безопасности и логики уязвимостей в понятном, безопасном и современном формате.
9+
10+
Платформа подходит для начинающих и тех, кто хочет научиться защищать свои сайты, не углубляясь в опасные методы.
11+
12+
🚀 Возможности
13+
14+
🎓 Теория — простые и наглядные объяснения веб-безопасности
15+
16+
🧪 Интерактивные симуляторы — безопасные лаборатории
17+
18+
🧠 Квизы и проверка знаний
19+
20+
💡 Учебные примеры защитных механизмов
21+
22+
🌗 Тёмная и светлая тема
23+
24+
⚡ Современный фронтенд-стек
25+
26+
🔒 Абсолютно безопасный формат (никаких реальных атак)
27+
28+
🛠️ Технологии
29+
30+
Frontend: React, TypeScript, Vite
31+
32+
UI: TailwindCSS, shadcn/ui, Framer Motion
33+
34+
Иконки: Lucide React
35+
36+
State: useState, custom hooks
37+
38+
Design: минимализм + плавные анимации
39+
40+
📦 Установка и запуск
41+
# Клонирование репозитория
42+
git clone https://github.com/Promastergame/WebSecAcademy.git
43+
cd websec-academy-main
44+
45+
# Установка зависимостей
46+
npm install
47+
48+
# Запуск dev-сервера
49+
npm run dev
50+
51+
👨‍💻 Автор
52+
53+
Promaster Development
54+
Разработчик, создающий сайты, игры и Telegram-ботов.
55+
Изучаю веб-безопасность, люблю современные технологии и эксперименты.
56+
57+
📫 Telegram: https://t.me/Promaster_Developer
58+
59+
🌐 GitHub: https://github.com/Promastergame
60+
61+
📜 Лицензия
62+
63+
Проект распространяется под кастомной лицензией
64+
WMIT-Safe License (MIT + безопасное использование).
65+
66+
Лицензия запрещает использование проекта для вредоносных целей
67+
и требует обязательно указывать автора:
68+
69+
“Developed by Promaster Development”
70+
71+
Полный текст лицензии — в файле LICENSE. или LICENSE-RU
72+
73+
⚠️ Безопасность
74+
75+
Платформа предназначена только для учебных целей:
76+
77+
разрешено изучать защитные механизмы
78+
79+
симуляции полностью безопасны
80+
81+
запрещено использовать проект для создания вредоносного ПО
82+
83+
запрещено обучение реальным атакам без разрешения автора
84+
85+
Проект ориентирован на безопасное образование и не является альтернативой OWASP.

‎components.json‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"$schema": "https://ui.shadcn.com/schema.json",
3+
"style": "default",
4+
"rsc": false,
5+
"tsx": true,
6+
"tailwind": {
7+
"config": "tailwind.config.ts",
8+
"css": "src/index.css",
9+
"baseColor": "slate",
10+
"cssVariables": true,
11+
"prefix": ""
12+
},
13+
"aliases": {
14+
"components": "@/components",
15+
"utils": "@/lib/utils",
16+
"ui": "@/components/ui",
17+
"lib": "@/lib",
18+
"hooks": "@/hooks"
19+
}
20+
}

‎eslint.config.js‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
import js from "@eslint/js";
2+
import globals from "globals";
3+
import reactHooks from "eslint-plugin-react-hooks";
4+
import reactRefresh from "eslint-plugin-react-refresh";
5+
import tseslint from "typescript-eslint";
6+
7+
export default tseslint.config(
8+
{ ignores: ["dist"] },
9+
{
10+
extends: [js.configs.recommended, ...tseslint.configs.recommended],
11+
files: ["**/*.{ts,tsx}"],
12+
languageOptions: {
13+
ecmaVersion: 2020,
14+
globals: globals.browser,
15+
},
16+
plugins: {
17+
"react-hooks": reactHooks,
18+
"react-refresh": reactRefresh,
19+
},
20+
rules: {
21+
...reactHooks.configs.recommended.rules,
22+
"react-refresh/only-export-components": ["warn", { allowConstantExport: true }],
23+
"@typescript-eslint/no-unused-vars": "off",
24+
},
25+
},
26+
);

0 commit comments

Comments
 (0)