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

• ⚡ 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

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

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

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

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

# GitHub Configuration
GITHUB_USERNAME=your_github_username
GITHUB_TOKEN=your_github_token
GITHUB_EMAIL=[email protected]

# NPM Configuration
NPM_USERNAME=your_npm_username
NPM_EMAIL=[email protected]
NPM_TOKEN=your_npm_token

# PyPI Configuration
PYPI_USERNAME=your_pypi_username
PYPI_TOKEN=your_pypi_token
PYPI_EMAIL=[email protected]

# Docker Hub Configuration
DOCKERHUB_USERNAME=your_docker_username
DOCKERHUB_TOKEN=your_docker_token

# GitLab Configuration
GITLAB_USERNAME=your_gitlab_username
GITLAB_TOKEN=your_gitlab_token
GITLAB_EMAIL=[email protected]

# Portfolio Configuration
PORTFOLIO_OUTPUT_DIR=./portfolio

• 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

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

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

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

• 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

# Install the package in development mode
pip install -e .

# Install development dependencies
pip install -e ".[dev]"

# Install dependencies
poetry install

# Activate the virtual environment
poetry shell

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.

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 = "[email protected]"
   token = "your_npm_token"
   
   # ... other services

.
├── 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

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

• 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

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

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

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

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

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

# 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

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

# App
NODE_ENV=development
PORT=3000

# GitHub
GITHUB_USERNAME=your_github_username
GITHUB_TOKEN=your_github_token
GITHUB_EMAIL=your_github_email

# NPM
NPM_USERNAME=your_npm_username
NPM_EMAIL=your_npm_email
NPM_TOKEN=your_npm_token

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

{
  "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"
  }
}

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

• 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

Here are some of my recent projects:

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

make publish-npm

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/*

make publish-docker

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

• domainLeak.com

• Pomoc askDomainer PL

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

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

• Pomoc askDomainer

• 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?

• edit