(DEFAULT_THEME);
+ const [mounted, setMounted] = useState(false);
+
+ useEffect(() => {
+ setMounted(true);
+
+ // Check localStorage first
+ const savedTheme = localStorage.getItem('theme');
+ if (savedTheme && themes.some(t => t.id === savedTheme)) {
+ setCurrentTheme(savedTheme);
+ document.documentElement.setAttribute('data-theme', savedTheme);
+ return;
+ }
+
+ // Check prefers-color-scheme
+ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+ const initialTheme = prefersDark ? DEFAULT_THEME : 'night';
+ setCurrentTheme(initialTheme);
+ document.documentElement.setAttribute('data-theme', initialTheme);
+ }, []);
+
+ const handleThemeChange = (themeId: string) => {
+ setCurrentTheme(themeId);
+ document.documentElement.setAttribute('data-theme', themeId);
+ localStorage.setItem('theme', themeId);
+ };
+
+ if (!mounted) {
+ return (
+
+ );
+ }
+
+ return (
+
+
+
+
+
+
+ {themes.map((theme) => (
+
+ handleThemeChange(theme.id)}
+ className={`justify-between ${currentTheme === theme.id ? 'active' : ''}`}
+ role="menuitem"
+ aria-current={currentTheme === theme.id ? 'true' : 'false'}
+ >
+ {theme.name}
+ {currentTheme === theme.id && (
+
+
+ )}
+
+
+ ))}
+
+
{title} | CTF-Kit
+
+
+ Skip to content
+
+
+
+
+
+ {breadcrumbs.length > 0 && (
+
+
+ )}
+
+
+
+
+
+
+
+
+
+
+
diff --git a/site/src/pages/404.astro b/site/src/pages/404.astro
new file mode 100644
index 0000000..dbd9702
--- /dev/null
+++ b/site/src/pages/404.astro
@@ -0,0 +1,39 @@
+---
+import Layout from '../layouts/Layout.astro';
+
+const base = import.meta.env.BASE_URL;
+---
+
+
+
+
+
+
404
+
Page Not Found
+
+ Oops! The page you're looking for doesn't exist. It might have been moved or deleted.
+
+
+
+
+
+
diff --git a/site/src/pages/create-issue.astro b/site/src/pages/create-issue.astro
new file mode 100644
index 0000000..77703b1
--- /dev/null
+++ b/site/src/pages/create-issue.astro
@@ -0,0 +1,137 @@
+---
+import Layout from '../layouts/Layout.astro';
+
+const breadcrumbs = [{ label: 'Create Issue' }];
+
+const issueTemplates = [
+ {
+ title: 'π Bug Report',
+ description: 'Report a bug or unexpected behavior',
+ url: 'https://github.com/cywf/ctf-kit/issues/new?template=bug_report.md&labels=bug',
+ icon: 'M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z',
+ color: 'error',
+ },
+ {
+ title: 'β¨ Feature Request',
+ description: 'Suggest a new feature or enhancement',
+ url: 'https://github.com/cywf/ctf-kit/issues/new?template=feature_request.md&labels=enhancement',
+ icon: 'M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z',
+ color: 'primary',
+ },
+ {
+ title: 'π Documentation',
+ description: 'Improve or fix documentation',
+ url: 'https://github.com/cywf/ctf-kit/issues/new?labels=documentation&title=docs:',
+ icon: 'M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253',
+ color: 'info',
+ },
+ {
+ title: 'π§ CTF Script/Tool',
+ description: 'Share or request a CTF script or tool',
+ url: 'https://github.com/cywf/ctf-kit/issues/new?labels=script,tool&title=tool:',
+ icon: 'M12 6V4m0 2a2 2 0 100 4m0-4a2 2 0 110 4m-6 8a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4m6 6v10m6-2a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4',
+ color: 'secondary',
+ },
+ {
+ title: 'π― CTF Challenge',
+ description: 'Document a CTF challenge or solution',
+ url: 'https://github.com/cywf/ctf-kit/issues/new?labels=ctf-challenge&title=challenge:',
+ icon: 'M9 12l2 2 4-4M7.835 4.697a3.42 3.42 0 001.946-.806 3.42 3.42 0 014.438 0 3.42 3.42 0 001.946.806 3.42 3.42 0 013.138 3.138 3.42 3.42 0 00.806 1.946 3.42 3.42 0 010 4.438 3.42 3.42 0 00-.806 1.946 3.42 3.42 0 01-3.138 3.138 3.42 3.42 0 00-1.946.806 3.42 3.42 0 01-4.438 0 3.42 3.42 0 00-1.946-.806 3.42 3.42 0 01-3.138-3.138 3.42 3.42 0 00-.806-1.946 3.42 3.42 0 010-4.438 3.42 3.42 0 00.806-1.946 3.42 3.42 0 013.138-3.138z',
+ color: 'accent',
+ },
+ {
+ title: 'π¬ General Question',
+ description: 'Ask a question or start a discussion',
+ url: 'https://github.com/cywf/ctf-kit/discussions/new',
+ icon: 'M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z',
+ color: 'success',
+ },
+];
+---
+
+
+
+
+
Create an Issue
+
+ Choose a template below to create an issue or start a discussion. This will take you to GitHub where you can provide more details.
+
+
+
+
+
+
+
+
+
+
Need help with something else?
+
+ Visit our
issue templates page for more options, or browse existing issues.
+
+
+
+
+
+
+
Before Creating an Issue
+
+ Search existing issues to avoid duplicates
+ Provide as much detail as possible
+ Use descriptive titles that summarize the issue
+ For bug reports, include steps to reproduce
+ Add relevant labels to help categorize your issue
+
+
+
+
diff --git a/site/src/pages/development-board.astro b/site/src/pages/development-board.astro
new file mode 100644
index 0000000..e51203b
--- /dev/null
+++ b/site/src/pages/development-board.astro
@@ -0,0 +1,21 @@
+---
+import Layout from '../layouts/Layout.astro';
+import DevelopmentBoardComponent from '../components/DevelopmentBoard';
+
+const breadcrumbs = [{ label: 'Development Board' }];
+---
+
+
+
+
diff --git a/site/src/pages/discussions.astro b/site/src/pages/discussions.astro
new file mode 100644
index 0000000..4ea2f42
--- /dev/null
+++ b/site/src/pages/discussions.astro
@@ -0,0 +1,21 @@
+---
+import Layout from '../layouts/Layout.astro';
+import DiscussionsComponent from '../components/Discussions';
+
+const breadcrumbs = [{ label: 'Discussions' }];
+---
+
+
+
+
diff --git a/site/src/pages/docs/[...slug].astro b/site/src/pages/docs/[...slug].astro
new file mode 100644
index 0000000..41e4b73
--- /dev/null
+++ b/site/src/pages/docs/[...slug].astro
@@ -0,0 +1,101 @@
+---
+import Layout from '../../layouts/Layout.astro';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+
+export async function getStaticPaths() {
+ const docsPath = join(process.cwd(), '..', 'docs');
+ const allDocs = await readdir(docsPath, { recursive: true, withFileTypes: true });
+
+ const paths = allDocs
+ .filter((dirent) => dirent.isFile() && dirent.name.endsWith('.md'))
+ .map((dirent) => {
+ const relativePath = join(dirent.parentPath || (dirent as any).path || '', dirent.name)
+ .replace(docsPath, '')
+ .replace(/^\//, '')
+ .replace('.md', '');
+
+ return {
+ params: { slug: relativePath },
+ };
+ });
+
+ return paths;
+}
+
+const { slug } = Astro.params;
+const slugPath = slug || '';
+
+const docsPath = join(process.cwd(), '..', 'docs');
+const filePath = join(docsPath, `${slugPath}.md`);
+
+let content = '';
+let title: string = 'Documentation';
+try {
+ content = await readFile(filePath, 'utf-8');
+
+ // Extract title from markdown
+ const titleMatch = content.match(/^#\s+(.+)$/m);
+ if (titleMatch && titleMatch[1]) {
+ title = titleMatch[1];
+ } else {
+ const fallback = slugPath.split('/').pop()?.replace(/-/g, ' ');
+ title = fallback || 'Documentation';
+ }
+} catch (error) {
+ content = `# Document Not Found\n\nThe requested document could not be found.`;
+ title = 'Not Found';
+}
+
+const breadcrumbs = [
+ { label: 'Documentation', href: `${import.meta.env.BASE_URL}/docs` },
+ { label: title },
+];
+
+// Simple markdown to HTML conversion (for basic rendering)
+// In production, you'd want to use a proper markdown parser
+const htmlContent = content
+ .replace(/^### (.+)$/gm, '$1 ')
+ .replace(/^## (.+)$/gm, '$1 ')
+ .replace(/^# (.+)$/gm, '$1 ')
+ .replace(/\*\*(.+?)\*\*/g, '$1 ')
+ .replace(/\*(.+?)\*/g, '$1 ')
+ .replace(/`(.+?)`/g, '$1')
+ .replace(/^\- (.+)$/gm, '$1 ')
+ .replace(/(.*<\/li>\n?)+/g, '')
+ .replace(/^\d+\. (.+)$/gm, ' $1 ')
+ .replace(/\[(.+?)\]\((.+?)\)/g, '$1 ')
+ .replace(/\n\n/g, '')
+ .replace(/^(?!<[h\|ul\|li])/gm, '
');
+
+const githubUrl = `https://github.com/cywf/ctf-kit/blob/main/docs/${slugPath}.md`;
+---
+
+
+
+
diff --git a/site/src/pages/docs/index.astro b/site/src/pages/docs/index.astro
new file mode 100644
index 0000000..a33e198
--- /dev/null
+++ b/site/src/pages/docs/index.astro
@@ -0,0 +1,109 @@
+---
+import Layout from '../../layouts/Layout.astro';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const breadcrumbs = [{ label: 'Documentation' }];
+
+// Get all markdown files from docs directory
+const docsPath = join(process.cwd(), '..', 'docs');
+const allDocs = await readdir(docsPath, { recursive: true, withFileTypes: true });
+const mdFiles = allDocs
+ .filter((dirent) => dirent.isFile() && dirent.name.endsWith('.md'))
+ .map((dirent) => {
+ const relativePath = join(dirent.parentPath || (dirent as any).path || '', dirent.name).replace(docsPath, '').replace(/^\//, '');
+ return {
+ name: dirent.name.replace('.md', ''),
+ path: relativePath,
+ category: relativePath.includes('/') ? relativePath.split('/')[0] : 'root',
+ };
+ });
+
+// Group by category
+const groupedDocs = mdFiles.reduce((acc, doc) => {
+ const category = doc.category || 'root';
+ if (!acc[category]) {
+ acc[category] = [];
+ }
+ acc[category].push(doc);
+ return acc;
+}, {} as Record);
+
+const base = import.meta.env.BASE_URL;
+---
+
+
+
+
+
Documentation
+
+ Browse our comprehensive guides and documentation for CTF competitions.
+
+
+
+
+
+
+
+
Contribute to Documentation
+
+ Found an error or want to add more content? Contributions are welcome! Visit the
docs folder on GitHub .
+
+
+
+
+ {Object.entries(groupedDocs).map(([category, docs]) => (
+
+
+ {category === 'root' ? 'General' : category.replace(/-/g, ' ')}
+
+
+
+ ))}
+
diff --git a/site/src/pages/index.astro b/site/src/pages/index.astro
new file mode 100644
index 0000000..d95d237
--- /dev/null
+++ b/site/src/pages/index.astro
@@ -0,0 +1,125 @@
+---
+import Layout from '../layouts/Layout.astro';
+
+const base = import.meta.env.BASE_URL;
+---
+
+
+
+
+
+
+
Welcome to CTF-Kit
+
+ Your collaborative and evolving resource for Capture The Flag competitions
+
+
+
+
+
+
+
+
Introduction
+
+ Welcome to the CTF-Kit repository! This project is designed to be a collaborative and evolving resource for anyone interested in participating in Capture The Flag (CTF) competitions. Whether you're a seasoned veteran or a newcomer to the world of CTFs, this repository aims to provide you with the tools, resources, and knowledge you need to succeed.
+
+
+
+
+
+
+
+
Vision and Goals
+
+
Our Vision
+
+ The vision for this repository is to become a central hub for CTF learning and collaboration. We aim to create a dynamic space where participants can share their insights, strategies, and resources to help each other improve and grow.
+
+
+
Goals
+
+ Facilitate Collaboration: Encourage participants to work together, share their findings, and contribute to the collective knowledge base.Improve CTF Strategies: Through shared experiences and resources, help users develop more effective strategies for tackling various types of CTF challenges.Create a Rich Database: Build a repository of scripts, tools, and writeups that serve as valuable references for future CTFs.
+
+
+
+
+
+
+
How to Use This Repository
+
+
+
+
1. Fork the Repository
+
Start by forking this repository to your own GitHub account.
+
+
+
+
2. Create a Branch
+
When you participate in a CTF, create a new branch in your forked repo. Name the branch after the CTF event you are participating in (e.g., metactf-august2024).
+
+
+
+
3. Work in Your Branch
+
Use this branch to document your progress, add scripts, and write up your solutions.
+
+
+
+
4. Contribute Back
+
After the CTF, you can submit a pull request to contribute your findings and improvements back to the main repository.
+
+
+
+
+
+
+
+
+
+
+
+
Start a CTF Branch
+
Follow our branching strategy to participate in CTF events and contribute your solutions.
+
+
+
+
+
+
+
Browse Scripts
+
Explore our collection of tools and scripts for various CTF challenges.
+
+
+
+
+
diff --git a/site/src/pages/statistics.astro b/site/src/pages/statistics.astro
new file mode 100644
index 0000000..a77b074
--- /dev/null
+++ b/site/src/pages/statistics.astro
@@ -0,0 +1,11 @@
+---
+import Layout from '../layouts/Layout.astro';
+import StatisticsComponent from '../components/Statistics';
+
+const breadcrumbs = [{ label: 'Statistics' }];
+---
+
+
+ Repository Statistics
+
diff --git a/site/src/pages/visualizer.astro b/site/src/pages/visualizer.astro
new file mode 100644
index 0000000..a64ba43
--- /dev/null
+++ b/site/src/pages/visualizer.astro
@@ -0,0 +1,45 @@
+---
+import Layout from '../layouts/Layout.astro';
+import MermaidViewer from '../components/MermaidViewer';
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const breadcrumbs = [{ label: 'Visualizer' }];
+
+// Try to read mermaid files
+let diagrams: Array<{ name: string; path: string; content: string }> = [];
+try {
+ const mermaidPath = join(process.cwd(), '..', 'mermaid');
+ const files = await readdir(mermaidPath, { recursive: true, withFileTypes: true });
+
+ const mmdFiles = files.filter((dirent) => dirent.isFile() && dirent.name.endsWith('.mmd'));
+
+ diagrams = await Promise.all(
+ mmdFiles.map(async (dirent) => {
+ const filePath = join(dirent.parentPath || (dirent as any).path || '', dirent.name);
+ const content = await readFile(filePath, 'utf-8');
+ return {
+ name: dirent.name.replace('.mmd', ''),
+ path: filePath,
+ content,
+ };
+ })
+ );
+} catch (error) {
+ // Mermaid directory doesn't exist or is empty
+ console.log('No mermaid diagrams found');
+}
+---
+
+
+
+
+
Project Visualizer
+
+ Interactive Mermaid diagrams showing project architecture, workflows, and relationships.
+
+
+
+
+
diff --git a/site/src/styles/global.css b/site/src/styles/global.css
new file mode 100644
index 0000000..5a5d71e
--- /dev/null
+++ b/site/src/styles/global.css
@@ -0,0 +1,68 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+ :root {
+ color-scheme: dark;
+ }
+
+ html {
+ scroll-behavior: smooth;
+ }
+
+ body {
+ @apply bg-base-100 text-base-content;
+ }
+
+ @media (prefers-reduced-motion: reduce) {
+ * {
+ animation-duration: 0.01ms !important;
+ animation-iteration-count: 1 !important;
+ transition-duration: 0.01ms !important;
+ }
+ }
+}
+
+@layer components {
+ .skip-to-content {
+ @apply absolute -top-10 left-0 z-50 bg-primary text-primary-content px-4 py-2 focus:top-0;
+ }
+
+ .prose-dark {
+ @apply max-w-none text-base-content;
+ }
+
+ .prose-dark h1 {
+ @apply text-4xl font-bold mb-6;
+ }
+
+ .prose-dark h2 {
+ @apply text-2xl font-bold mt-8 mb-4;
+ }
+
+ .prose-dark h3 {
+ @apply text-xl font-bold mt-6 mb-3;
+ }
+
+ .prose-dark p {
+ @apply mb-4;
+ }
+
+ .prose-dark pre {
+ @apply bg-base-300 p-4 rounded-lg overflow-x-auto;
+ }
+
+ .prose-dark code {
+ @apply bg-base-300 px-2 py-1 rounded text-sm;
+ }
+
+ .prose-dark a {
+ @apply text-primary hover:underline;
+ }
+
+ .prose-dark ul,
+ .prose-dark ol {
+ @apply list-disc list-inside space-y-2 my-4 ml-4;
+ }
+}
diff --git a/site/tailwind.config.mjs b/site/tailwind.config.mjs
new file mode 100644
index 0000000..7af1646
--- /dev/null
+++ b/site/tailwind.config.mjs
@@ -0,0 +1,70 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+ content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'],
+ theme: {
+ extend: {},
+ },
+ plugins: [require('daisyui')],
+ daisyui: {
+ themes: [
+ 'night',
+ 'dracula',
+ 'cyberpunk',
+ {
+ 'dark-neon': {
+ 'primary': '#00ffff',
+ 'secondary': '#ff00ff',
+ 'accent': '#00ff00',
+ 'neutral': '#0a0a0a',
+ 'base-100': '#0f0f0f',
+ 'base-200': '#1a1a1a',
+ 'base-300': '#252525',
+ 'info': '#00d4ff',
+ 'success': '#00ff88',
+ 'warning': '#ffaa00',
+ 'error': '#ff0055',
+ },
+ 'hackerman': {
+ 'primary': '#00ff00',
+ 'secondary': '#00aa00',
+ 'accent': '#00ffaa',
+ 'neutral': '#000000',
+ 'base-100': '#0d0d0d',
+ 'base-200': '#151515',
+ 'base-300': '#1d1d1d',
+ 'info': '#00ccff',
+ 'success': '#00ff00',
+ 'warning': '#ffcc00',
+ 'error': '#ff0000',
+ },
+ 'gamecore': {
+ 'primary': '#8b5cf6',
+ 'secondary': '#ec4899',
+ 'accent': '#f59e0b',
+ 'neutral': '#1e1e2e',
+ 'base-100': '#0f0f1e',
+ 'base-200': '#161628',
+ 'base-300': '#1e1e3f',
+ 'info': '#3b82f6',
+ 'success': '#10b981',
+ 'warning': '#f59e0b',
+ 'error': '#ef4444',
+ },
+ 'neon-accent': {
+ 'primary': '#ff006e',
+ 'secondary': '#8338ec',
+ 'accent': '#3a86ff',
+ 'neutral': '#14141f',
+ 'base-100': '#0a0a12',
+ 'base-200': '#12121d',
+ 'base-300': '#1a1a28',
+ 'info': '#06b6d4',
+ 'success': '#14f195',
+ 'warning': '#fbbf24',
+ 'error': '#f43f5e',
+ },
+ },
+ ],
+ darkTheme: 'night',
+ },
+};
diff --git a/site/tsconfig.json b/site/tsconfig.json
new file mode 100644
index 0000000..0f7c346
--- /dev/null
+++ b/site/tsconfig.json
@@ -0,0 +1,8 @@
+{
+ "extends": "astro/tsconfigs/strictest",
+ "compilerOptions": {
+ "jsx": "react-jsx",
+ "jsxImportSource": "react",
+ "types": ["node"]
+ }
+}
From efbcbc7abeaa0a6057262c5a875cd7d7ae39b2a6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 2 Nov 2025 01:42:24 +0000
Subject: [PATCH 3/3] Add example Mermaid diagrams and rebuild site
Co-authored-by: cywf <100837335+cywf@users.noreply.github.com>
---
mermaid/contribution-flow.mmd | 26 ++++++++++++++++++++++++++
mermaid/ctf-workflow.mmd | 27 +++++++++++++++++++++++++++
2 files changed, 53 insertions(+)
create mode 100644 mermaid/contribution-flow.mmd
create mode 100644 mermaid/ctf-workflow.mmd
diff --git a/mermaid/contribution-flow.mmd b/mermaid/contribution-flow.mmd
new file mode 100644
index 0000000..de9bc7f
--- /dev/null
+++ b/mermaid/contribution-flow.mmd
@@ -0,0 +1,26 @@
+graph LR
+ A[CTF-Kit Repository] --> B[Fork Repository]
+ B --> C[Create Branch]
+ C --> D{CTF Event}
+
+ D --> E[Use Tools & Scripts]
+ E --> F[Document Findings]
+ F --> G[Add Solutions]
+
+ G --> H{Event Complete?}
+ H -->|No| E
+ H -->|Yes| I[Submit Pull Request]
+
+ I --> J[Code Review]
+ J --> K{Approved?}
+ K -->|Yes| L[Merge to Main]
+ K -->|No| M[Make Changes]
+ M --> I
+
+ L --> N[Community Benefits]
+ N --> O[Enhanced Repository]
+
+ style A fill:#8b5cf6,stroke:#8b5cf6,color:#fff
+ style I fill:#00ffff,stroke:#00ffff,color:#000
+ style L fill:#00ff00,stroke:#00ff00,color:#000
+ style O fill:#ff00ff,stroke:#ff00ff,color:#000
diff --git a/mermaid/ctf-workflow.mmd b/mermaid/ctf-workflow.mmd
new file mode 100644
index 0000000..5c554c2
--- /dev/null
+++ b/mermaid/ctf-workflow.mmd
@@ -0,0 +1,27 @@
+graph TD
+ A[Start CTF] --> B{Choose Challenge Type}
+ B -->|Web| C[Web Exploitation]
+ B -->|Crypto| D[Cryptography]
+ B -->|Forensics| E[Forensics]
+ B -->|Reversing| F[Reverse Engineering]
+ B -->|Misc| G[Miscellaneous]
+
+ C --> H[Enumerate & Scan]
+ D --> H
+ E --> H
+ F --> H
+ G --> H
+
+ H --> I[Find Vulnerability]
+ I --> J{Exploit Successful?}
+ J -->|Yes| K[Capture Flag]
+ J -->|No| L[Try Different Approach]
+ L --> H
+
+ K --> M[Document Solution]
+ M --> N[Submit Flag]
+ N --> O[End]
+
+ style A fill:#00ffff,stroke:#00ffff,color:#000
+ style K fill:#00ff00,stroke:#00ff00,color:#000
+ style O fill:#ff00ff,stroke:#ff00ff,color:#000