project-navigation

Reference for the NetAlertX codebase structure, key file paths, and configuration locations. Use this when exploring the codebase or looking for specific components like the backend entry point, frontend files, or database location.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Project Navigation

Name: project-navigation
Rating: 76.8 (1 reviews)
Author: netalertx

Key Paths

Component	Path
Workspace root	`/workspaces/NetAlertX`
Backend entry	`server/__main__.py`
API server	`server/api_server/api_server_start.py`
Plugin system	`server/plugin.py`
Initialization	`server/initialise.py`
Frontend	`front/`
Frontend JS	`front/js/common.js`
Frontend PHP	`front/php/server/*.php`
Plugins	`front/plugins/`
Plugin template	`front/plugins/__template`
Database helpers	`server/db/db_helper.py`
Device model	`server/models/device_instance.py`
Messaging	`server/messaging/`
Workflows	`server/workflows/`

Architecture

NetAlertX uses a frontend–backend architecture: the frontend runs on PHP + Nginx (see front/), the backend is implemented in Python (see server/), and scheduled tasks are managed by a supercronic scheduler.

Runtime Paths

Data	Path
Config (runtime)	`/data/config/app.conf`
Config (default)	`back/app.conf`
Database	`/data/db/app.db`
API JSON cache	`/tmp/api/*.json`
Logs	`/tmp/log/`
Plugin logs	`/tmp/log/plugins/`

Environment Variables

Use these instead of hardcoding paths:

NETALERTX_DB
NETALERTX_LOG
NETALERTX_CONFIG
NETALERTX_DATA
NETALERTX_APP

Documentation

Topic	Path
Plugin development	`docs/PLUGINS_DEV.md`
System settings	`docs/SETTINGS_SYSTEM.md`
API docs	`docs/API_*.md`
Debug guides	`docs/DEBUG_*.md`

Repository: netalertx/NetAlertX
Path: .gemini/skills/project-navigation/SKILL.md
Commit: 20ddf48

Last updated: 7 days ago
First committed: about 1 month ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.