StackPilot

StackPilot is a multilingual developer toolkit for daily coding workflows.

It brings practical tools into one fast web app so you can encode, decode, convert, format, validate, and debug data without switching across multiple websites.

Links

• Website: https://nishantdev.space
• GitHub: https://github.com/codewithevilxd
• Contact: codewithevilxd@gmail.com

Table of Contents

1. Highlights
2. Tool Categories
3. Tech Stack
4. Getting Started
5. Scripts
6. Architecture
7. Branding Assets
8. SEO
9. Internationalization
10. Quality Checklist
11. Deployment
12. Contributing
13. License

Highlights

• Unified toolbox for frequent engineering tasks
• Consistent, responsive UI
• Browser-first workflow for fast interaction
• Locale-aware routing and translation system
• Self-host friendly architecture

Tool Categories

• Encode/Decode : Base64, URL encoding, character escaping
• Generators : Password, UUID, hash, QR code, lorem ipsum
• Format/Optimize : Code formatter, code minifier, SVG optimizer
• Convert : Color conversion, data format conversion, text case conversion
• Utilities : Text compare, character count, keyboard event inspector
• Date/Time : Timestamp conversion, time interval, timezone helpers

Tech Stack

• Next.js 16 (App Router + Turbopack)
• React 19
• TypeScript 5
• Tailwind CSS 4 + shadcn/ui + Radix primitives
• next-intl for i18n
• Vitest + Testing Library
• ESLint + Prettier

Getting Started

Prerequisites

• Node.js 20+
• pnpm 10+

Install pnpm via Corepack if needed:

corepack enable
corepack prepare pnpm@latest --activate

Install and Run

pnpm install
pnpm dev

Open http://localhost:3000.

Scripts

• pnpm dev: start development server
• pnpm build: create production build
• pnpm start: run production server
• pnpm analyze: run bundle analysis build
• pnpm lint: run ESLint
• pnpm typecheck: run TypeScript checks
• pnpm test: run unit tests
• pnpm format: format code
• pnpm format:check: verify formatting
• pnpm run image:app-launcher: regenerate public/app-launcher.png
• pnpm run image:apple-touch-icon: regenerate public/apple-touch-icon.png
• pnpm run image:favicon: regenerate public/favicon.svg and public/favicon.ico

Architecture

• app: routes, layouts, metadata, sitemap, manifest
• components: reusable UI and feature components
• config: central project configuration
• i18n: locale setup and routing
• messages: translation resources by locale
• lib: shared utilities and tests
• public: static files and icons
• scripts: automation scripts

Branding Assets

Use one source image and regenerate app icons from scripts:

• Source image: public/image.png
• Launcher script: scripts/make-app-launcher.ps1
• Favicon script: scripts/make-favicon-assets.ps1

This keeps icon variants consistent across web, PWA, and social metadata.

SEO

SEO is implemented through multiple layers:

• Global metadata in app/layout.tsx
• Open Graph and Twitter cards in app/layout.tsx
• Structured data (JSON-LD) in app/[locale]/(pages)/(content)/page.tsx
• Dynamic sitemap in app/sitemap.ts
• Manifest in app/manifest.ts

For best discoverability of StackPilot and codewithevilxd:

1. Submit sitemap in Google Search Console
2. Keep portfolio and GitHub backlinks aligned with StackPilot naming
3. Publish updates regularly to keep pages fresh for crawlers

Internationalization

• Locale config: i18n/routing.ts
• Messages: messages

To add a new locale:

1. Add locale in routing config
2. Add corresponding translation JSON files
3. Validate all tool page message keys

Quality Checklist

Run before pushing:

pnpm lint
pnpm typecheck
pnpm test
pnpm format:check

Deployment

• Deploy on any Node-compatible platform
• Confirm production domain values in config/site.ts
• Keep public assets synchronized before release

Contributing

Contributions are welcome.

1. Fork the repo
2. Create a feature branch
3. Add tests for behavior changes
4. Run quality checks
5. Open a pull request with clear summary and screenshots for UI changes

License

Licensed under GPL-3.0.

See LICENSE for full text.