skills.rest
edfenton
edfentonCOMMUNITY
Explore all skills by this author →
Website𝕏@edfentonGitHub

nean-teardown

Drop the PostgreSQL database, delete local files, and optionally remove the GitHub repository for a NEAN project.

3|1|Updated Feb 12, 2026
Search Tags:#automation#devops#database#github#cleanup#teardown#nean
One-click install
npx skills add https://github.com/edfenton/claude-skills --skill nean-teardown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nean-teardown
Source: https://github.com/edfenton/claude-skills/tree/main/nean/nean-teardown
Command: npx skills add https://github.com/edfenton/claude-skills --skill nean-teardown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tear down a NEAN project by dropping its PostgreSQL database, deleting local project files, and optionally removing the GitHub repository to reclaim space and reduce risk of stale configurations.

Core Features & Use Cases

  • Detects a NEAN project by checking for: nx.json, apps/api/, libs/shared/.
  • Drops the database using the project’s configured name or environment.
  • Kills running dev servers on common ports and then deletes all local files.
  • Deletes the GitHub repository if --delete-repo is used, while leaving a local copy if not.

Quick Start

Run the nean-teardown command from the project root, using optional flags like --delete-repo to remove the GitHub repository or --keep-db to preserve the database.

Frequently Asked Questions about nean-teardown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely tear down a NEAN project and drop its PostgreSQL database?▼

To tear down a NEAN project, run the teardown command from the project root to drop the PostgreSQL database, kill running dev servers, and delete all local files. You can use the --keep-db flag to preserve the database during cleanup.

Can I automatically delete my GitHub repository when tearing down a NEAN project?▼

Yes, you can delete the GitHub repository during the NEAN teardown by using the --delete-repo flag, which requires proper GitHub authentication. If this flag is omitted, the remote repo remains intact while local files are removed.

What is required to detect and run a NEAN project teardown successfully?▼

A NEAN project teardown requires Postgres availability and a confirmed project root containing nx.json, apps/api/, and libs/shared/ directories. GitHub authentication is additionally required if you opt to delete the remote repository.

What is the best way to clean up local development files and dev servers for a NEAN project?▼

The best way to clean up local files and dev servers is running the NEAN teardown command, which automatically terminates processes on common dev ports before deleting all local project files to prevent stale configurations.

Why does the teardown process need to kill dev servers before deleting local files?▼

Killing dev servers before deleting local files prevents active processes from locking resources or causing errors during the teardown workflow, ensuring the NEAN project's local files are fully and safely removed from your system.

Does the NEAN teardown command work if I only want to remove local files without dropping the database?▼

Yes, the teardown command supports removing local files and killing dev servers without dropping the database by using the --keep-db flag, allowing you to reclaim local space while preserving the PostgreSQL database.

Related Skills

Explore More Software Engineering Skills→
edfentonedfenton
3

nean-add-auth

Automates adding Passport.js and JWT authentication to NEAN projects with optional OAuth providers.

Community
Advanced
sburlsburl
26

cleanup-worktrees

Remove stale Git worktrees and prune related branches.

Community
Advanced
edfentonedfenton
3

nean-kit

Initialize NEAN projects with stack decisions, scaffolding, and GitHub security.

Community
Advanced
PillArmyPillArmy

postgres-batch-delete

Automates batch deletion of records from PostgreSQL tables using a fluent API.

Official
Advanced