digitName.com

Digital naming and domain management tools and resources, now rebuilt with modern web technologies.

🚀 Features

• ⚡ Blazing fast performance with Vite
• 🎨 Beautiful UI components with Mantine
• 📱 Fully responsive design
• 🔒 Secure environment variable management
• 🏗️ Modern React architecture
• 🐍 Python backend with environment-based configuration
• 🔄 Easy content updates through environment variables

🛠️ Prerequisites

• Node.js 16.x or higher
• npm 8.x or higher (comes with Node.js)
• Python 3.8 or higher
• Git

🚀 Quick Start

Frontend Development

1. Clone the repository

   git clone https://github.com/digitname/www.git
   cd www

2. Set up environment variables

   cp .env.example .env
   # Edit .env file with your configuration

3. Install dependencies

   npm install

4. Start the development server

   make dev

   The frontend will be available at http://localhost:3000

Backend Development

1. Set up Python environment

   python -m venv venv
   source venv/bin/activate # On Windows: venv\Scripts\activate
   pip install -r requirements.txt

2. Initialize the application

   # Install the package in development mode
   pip install -e .# Initialize environment variables
   digitname init

3. Check your configuration

   digitname check

4. Generate your portfolio

   digitname generate-portfolio

📝 Configuration

All configuration is managed through environment variables in the .env file. The application will automatically load these variables when started.

Required Environment Variables

# GitHub ConfigurationGITHUB_USERNAME=your_github_usernameGITHUB_TOKEN=your_github_tokenGITHUB_EMAIL=your.email@example.com# NPM ConfigurationNPM_USERNAME=your_npm_usernameNPM_EMAIL=your.email@example.comNPM_TOKEN=your_npm_token# PyPI ConfigurationPYPI_USERNAME=your_pypi_usernamePYPI_TOKEN=your_pypi_tokenPYPI_EMAIL=your.email@example.com# Docker Hub ConfigurationDOCKERHUB_USERNAME=your_docker_usernameDOCKERHUB_TOKEN=your_docker_token# GitLab ConfigurationGITLAB_USERNAME=your_gitlab_usernameGITLAB_TOKEN=your_gitlab_tokenGITLAB_EMAIL=your.email@example.com# Portfolio ConfigurationPORTFOLIO_OUTPUT_DIR=./portfolio

🔧 Available Commands

• digitname init - Initialize the application and create a .env file
• digitname check - Verify your current configuration
• digitname generate-portfolio - Generate your portfolio website
• make dev - Start the development server
• make build - Build the application for production
• make test - Run tests

🐳 Docker Support

You can also run the application using Docker:

# Build the Docker image
docker build -t digitname .# Run the application
docker run -p 3000:3000 --env-file .env digitname

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to contribute to this project.

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

🚀 Features

• Centralized management of development accounts (GitHub, NPM, PyPI, Docker Hub, GitLab)
• Beautiful, responsive portfolio generation
• Interactive token setup assistant
• Secure environment variable management
• Extensible architecture for adding more platforms
• Command-line interface for easy management

📦 Installation

Using pip (recommended)

# Install the package in development mode
pip install -e .# Install development dependencies
pip install -e ".[dev]"

Using Poetry

# Install dependencies
poetry install
# Activate the virtual environment
poetry shell

🛠️ Usage

Quick Start

1. Setup Environment

   # Create .env file from example
   make setup-env
   # Run interactive token setup (recommended)
   make setup-tokens

   This will guide you through setting up all required API tokens.

2. Generate Your Portfolio

   # Install in development mode
   pip install -e .# Generate your portfolio
   python -m digitname generate-portfolio

   This will generate your portfolio in the portfolio directory by default.

3. View Your Portfolio Open portfolio/index.html in your web browser.

Manual Configuration (Alternative)

If you prefer to set up tokens manually:

1. Initialize Configuration

   python -m digitname init

   This creates a config/accounts.toml file with default values.

2. Edit Configuration Update the config/accounts.toml file with your account details:

   [github]
   username = "your_github_username"token = "your_github_token"
   [npm]
   username = "your_npm_username"email = "your.email@example.com"token = "your_npm_token"# ... other services

🛠 Development

Project Structure

.
├── digitname/ # Main package
│ ├── __init__.py
│ ├── accounts.py # Account management
│ ├── cli.py # Command-line interface
│ ├── portfolio.py # Portfolio generation
│ └── templates/ # HTML/CSS/JS templates
├── scripts/ # Utility scripts
│ ├── setup-tokens.py # Interactive token setup
│ └── setup-tokens.sh # Setup script wrapper
├── tests/ # Test files
├── config/ # Configuration files
├── portfolio/ # Generated portfolio (created after first run)
├── pyproject.toml # Project metadata and dependencies
├── setup.py # Package installation script
└── README.md # This file

Available Commands

Setup

• make setup-env - Create .env file from example
• make setup-tokens - Interactive setup for API tokens (recommended)
• make check-env - Verify environment configuration

Development

• make install - Install dependencies
• make test - Run tests
• make lint - Run linters
• make format - Format code
• make clean - Clean build artifacts
• make build - Build package
• make publish - Publish to PyPI
• make portfolio - Generate portfolio

Token Management

Use the interactive token setup for the best experience:

make setup-tokens

This will guide you through:

1. Opening the token generation pages in your browser
2. Generating tokens with the correct permissions
3. Securely storing them in your local .env file

Supported services:

• GitHub
• NPM
• PyPI
• Docker Hub
• GitLab

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on how to contribute to this project.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Python and love
• Uses Typer for CLI
• Styled with Tailwind CSS
• Icons from Tabler Icons

🏗️ Project Structure

www/
├── assets/ # Static assets
│ └── portfolio/ # Portfolio assets
│ ├── icons/ # Project icons (100x100px)
│ ├── thumbnails/ # Project thumbnails (400x300px)
│ └── data.json # Portfolio data (auto-generated)
├── config/ # Service configurations
│ ├── github/ # GitHub API config
│ ├── npm/ # NPM config
│ ├── pypi/ # PyPI config
│ ├── docker/ # Docker config
│ └── gitlab/ # GitLab config
├── react-app/ # React application (main frontend)
│ ├── public/ # Static files
│ └── src/ # Source files
│ ├── assets/ # Images, fonts, etc.
│ ├── components/ # Reusable components
│ ├── pages/ # Page components
│ ├── styles/ # Global styles
│ ├── utils/ # Utility functions
│ ├── App.jsx # Main App component
│ └── main.jsx # Application entry point
├── scripts/ # Utility scripts
├── .env.example # Environment variables example
├── .gitignore # Git ignore file
├── Makefile # Project commands
├── package.json # Project configuration
├── README.md # This file
└── requirements.txt # Python dependencies

🛠️ Development

Available Commands

# Install dependencies
make deps
# Start development server (port 8033)
make run
# Build for production
make build
# Run tests
make test# Clean build artifacts
make clean
# Create a new release
make release
# Update portfolio data and generate assets
make update-portfolio

Environment Variables

Create a .env file in the root directory with the following variables:

# AppNODE_ENV=developmentPORT=3000# GitHubGITHUB_USERNAME=your_github_usernameGITHUB_TOKEN=your_github_tokenGITHUB_EMAIL=your_github_email# NPMNPM_USERNAME=your_npm_usernameNPM_EMAIL=your_npm_emailNPM_TOKEN=your_npm_token

🖼️ Portfolio Management

Adding a New Project

1. Add your project image to assets/portfolio/ (e.g., myproject.jpg or myproject.png)
2. Run the portfolio update script:

   make update-portfolio

3. The script will:
   • Generate a thumbnail (400x300px) in assets/portfolio/thumbnails/
   • Generate an icon (100x100px) in assets/portfolio/icons/
   • Update assets/portfolio/data.json with the new project

Portfolio Data Structure

{
"lastUpdated": "2025-05-26T22:48:00.245Z",
"items": [
{
"id": "test-project",
"title": "Test Project",
"description": "Description for test-project",
"image": "test-project.png",
"url": "https://example.com/projects/test-project",
"tags": ["web", "design"],
"date": "2025-05-26",
"metadata": {
"width": 1,
"height": 1,
"format": "png",
"size": "0.07 KB"
},
"thumbnail": "thumbnails/test-project.png",
"icon": "icons/test-project.png"
}
],
"stats": {
"totalItems": 1,
"lastUpdated": "2025-05-26T22:48:00.245Z"
}
}

Supported Image Formats

• .jpg / .jpeg
• .png
• .webp

Thumbnails and Icons

• Thumbnails are generated at 400x300px (JPEG format, 80% quality)
• Icons are generated at 100x100px (PNG format, 90% quality)
• Original aspect ratio is maintained with cover fit
• Images are never enlarged beyond their original dimensions

🚀 My Projects

Here are some of my recent projects:

Test Project

• Description: Description for test-project
• Technologies: Web, Design
• Last Updated: May 26, 2025

📦 Publishing

Publish to NPM

make publish-npm

Publish to PyPI

1. First, make sure you have set up your PyPI token:

   make setup-tokens
   # Select PyPI and follow the instructions

2. Build and publish the package:

   make build
   make publish-pypi

   The publish command will use the PYPI_TOKEN from your .env file for authentication.

3. If you need to use the token directly with twine:

   python -m twine upload -u __token__ -p ${PYPI_TOKEN} dist/*

Publish to Docker Hub

make publish-docker

Reports

• Raport rynku domen, 2024.digitname.com - Jak zmieniał się rynek domen w ostatniej dekadzie? Jak zmieni się rynek do roku 2030?

Portfolio

• domainLeak.com

Services

• Pomoc askDomainer PL

Domain Information

• Numery telefonów i domeny internetowe
• 100 najczęstszych technicznych problemów z domenami internetowymi

---

Tom Sapletta

Na co dzień DevOps i ewangelista hipermodularyzacji, oferuję wsparcie techniczne dla startupów i specjalistów. Posiadam globalne doświadczenie w research-u i wdrażaniu i utrzymaniu systemów informatycznych. Ułatwiam dopasowanie rozwiązania do potrzeb, zapraszam:

• Tom Sapletta, Linkedin
• Tom Sapletta, Github
• Softreck - Leadership Through Software Development

Usługi

• Pomoc askDomainer

Raporty:

• Rynek pracy w EU okiem Polaka - Raport 2024 - Jak zmieniał się rynek pracy w ostatniej dekadzie? Jak zmieni się rynek do roku 2030?
• Detekcja obiektów w systemach wizyjnych - Raport 2024 - Jak zmieniał się rynek systemów wizyjnych w zastosowaniach przemysłowych w ostatniej dekadzie? Jak zmieni się rynek do roku 2030?

---

<script src="https://cdn.jsdelivr.net/npm/mermaid@10.8.0/dist/mermaid.min.js"></script> <script> var config = { startOnReady:true, theme: 'forest', flowchart:{ useMaxWidth:false, htmlLabels:true } }; mermaid.initialize(config); mermaid.init(undefined, '.language-mermaid'); </script> <script type="module"> /** import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs'; mermaid.initialize({ startOnLoad: true, theme: 'dark' }); */ </script>

---

• edit