b1kr3m's Development Environment

A lightweight, highly customized Neovim configuration tailored for security researchers, bug bounty hunters, and penetration testers. Built with performance and efficiency in mind for daily security testing workflows.

🎯 Philosophy

As a security enthusiast who regularly breaks and tests systems, I needed a development environment that is:

• Lightweight - Fast startup and minimal resource usage
• Reliable - Stable enough for daily security research
• Customizable - Easily adaptable to evolving workflows
• Efficient - Optimized for rapid development and testing

This configuration prioritizes functionality over flashy features, providing a solid foundation for security research and development work.

✨ Features

🔧 Core Capabilities

• LazyVim-based: Built on the excellent LazyVim framework for sensible defaults
• Language Support: Preconfigured for Go, Python, JavaScript, Rust, Shell scripting, and web development
• Smart Completion: Blink.cmp with Copilot and Codeium AI assistance
• Live Development: Built-in live server for web testing and development
• Git Integration: Comprehensive Git workflow support
• Symbol Navigation: Aerial plugin for code structure overview
• Auto-save: Intelligent auto-save with configurable triggers

🎨 UI Enhancements

• Catppuccin & Tokyo Night: Beautiful, eye-friendly color schemes
• Dashboard: Custom startup screen with quick access shortcuts
• Bufferline: Enhanced buffer management
• Statusline: Informative lualine configuration
• Noice: Modern UI for messages, cmdline, and popups

🚀 Developer Experience

• Fuzzy Finding: Telescope and fzf-lua for rapid file navigation
• LSP Support: Full Language Server Protocol integration
• Format on Save: Automatic code formatting with conform.nvim
• Linting: Real-time code analysis with nvim-lint
• Treesitter: Advanced syntax highlighting and code understanding
• Debugging: DAP integration for debugging sessions

📋 Prerequisites

• Neovim >= 0.9.0
• Git >= 2.19.0
• Node.js (for Copilot and some LSPs)
• Python 3 (for Python development)
• Go (for Go development)
• Rust (optional, for Rust development)
• A Nerd Font (recommended: JetBrainsMono Nerd Font)

System-Specific Requirements

Arch Linux (with Hyprland):

sudo pacman -S neovim git nodejs npm python python-pip
yay -S ttf-jetbrains-mono-nerd  # or your preferred AUR helper

🔧 Installation

Fresh Installation

1. Backup existing configuration (if any):

mv ~/.config/nvim ~/.config/nvim.backup
mv ~/.local/share/nvim ~/.local/share/nvim.backup
mv ~/.local/state/nvim ~/.local/state/nvim.backup
mv ~/.cache/nvim ~/.cache/nvim.backup

2. Clone this repository:

git clone https://github.com/b1kr3m/PDE.git ~/.config/nvim

3. Install dependencies:

# Install Python formatters (optional)
pip install black isort

4. Launch Neovim:

nvim

LazyVim will automatically install all plugins on first launch.

⚙️ Configuration Structure

~/.config/nvim/
├── init.lua                    # Entry point
├── lua/
│   ├── config/
│   │   ├── autocmds.lua       # Auto commands
│   │   ├── keymaps.lua        # Custom key mappings
│   │   ├── lazy.lua           # Plugin manager setup
│   │   └── options.lua        # Neovim options
│   └── plugins/
│       ├── editor/            # Editor enhancement plugins
│       │   ├── aerial.lua     # Symbol outline
│       │   ├── auto-save.lua  # Auto-save functionality
│       │   ├── live-server.lua # Web development server
│       │   └── telescope.lua  # Fuzzy finder
│       ├── lang/              # Language-specific configs
│       │   ├── css.lua        # CSS/SCSS/Tailwind
│       │   ├── go.lua         # Go development
│       │   ├── html.lua       # HTML + Emmet + Live Server
│       │   ├── javascript.lua # JavaScript + ESLint
│       │   ├── python.lua     # Python development
│       │   ├── react.lua      # React JSX/TSX helpers
│       │   ├── rust.lua       # Rust development
│       │   ├── shell.lua      # Shell scripting
│       │   └── typescript.lua # TypeScript + TS Server
│       └── ui/                # UI enhancements
│           └── dashboard.lua  # Startup dashboard
├── lazy-lock.json             # Plugin version lock
├── lazyvim.json               # LazyVim extras
└── stylua.toml                # Lua formatter config

🎮 Key Mappings

Custom Mappings

Mode	Key	Action	Description
Insert	jj	<Esc>	Quick escape to normal mode
Normal	<leader>cs	:AerialToggle	Toggle symbol outline
Normal	<leader>as	:ASToggle	Toggle auto-save
Normal	<leader>cL	:LiveServerStart	Start live server (HTML files)
Normal	<leader>cl	:LiveServerStop	Stop live server

LazyVim Default Mappings

For a complete list of default LazyVim keybindings, see LazyVim Keymaps.

Most Used:

• <leader>ff - Find files
• <leader>fg - Live grep
• <leader>e - Toggle file explorer
• <leader>gg - LazyGit
• <C-/> - Toggle terminal

🔌 Installed Plugins

Essential Plugins

• LazyVim - Neovim config framework
• lazy.nvim - Plugin manager
• telescope.nvim - Fuzzy finder
• neo-tree.nvim - File explorer
• nvim-treesitter - Syntax parsing

Coding Assistance

• blink.cmp - Completion engine
• copilot.lua - GitHub Copilot integration
• codeium.nvim - Codeium AI integration
• conform.nvim - Code formatting
• nvim-lint - Linting

UI Enhancements

• catppuccin - Color scheme
• tokyonight.nvim - Color scheme
• lualine.nvim - Status line
• bufferline.nvim - Buffer tabs
• noice.nvim - Modern UI

Language Support

• LSPs: gopls, pyright, rust-analyzer, typescript-language-server, html-lsp, css-lsp
• Formatters: gofumpt, black, prettier, shfmt
• Linters: shellcheck, eslint_d

🛠️ Customization

Changing the Color Scheme

Edit lua/config/lazy.lua to modify the colorscheme preference:

install = { colorscheme = { "catppuccin", "tokyonight" } },

Adding New Languages

Create a new file in lua/plugins/lang/ following the existing patterns. Example structure:

return {
  -- Treesitter
  {
    "nvim-treesitter/nvim-treesitter",
    opts = function(_, opts)
      vim.list_extend(opts.ensure_installed, { "your-language" })
    end,
  },
  
  -- LSP configuration
  {
    "neovim/nvim-lspconfig",
    opts = {
      servers = {
        your_lsp = {},
      },
    },
  },
}

React + TypeScript Setup

This config now supports a proper React workflow out of the box:

• tsx, typescript, javascript, javascriptreact, and typescriptreact via Treesitter
• ts_ls for TypeScript/JavaScript language features
• eslint and eslint_d for React/TypeScript linting
• tailwindcss LSP for Tailwind projects
• emmet_ls for fast JSX/TSX markup expansion
• prettierd / prettier for formatting

For a React project, install the project-side tools as well:

npm install -D typescript eslint prettier @types/react @types/react-dom

If you use Vite:

npm create vite@latest my-app -- --template react-ts
cd my-app
npm install

Then open the project with:

nvim .

On first launch inside Neovim:

1. Run :Mason and confirm typescript-language-server, eslint-lsp, tailwindcss-language-server, prettierd, and emmet-ls are installed.
2. Open a .tsx file and run :LspInfo to verify ts_ls is attached.
3. Run :ConformInfo if formatting is not triggering.

Recommended filetypes for React work:

• .tsx for React components written in TypeScript
• .ts for utility/modules without JSX
• .jsx only if the project is JavaScript-based
• .js for non-React plain JavaScript

Modifying Dashboard

Edit lua/plugins/ui/dashboard.lua to customize the startup screen, including shortcuts and ASCII art.

Happy Hacking! 🔐