@foss.global/foss.global

• readme.md for @foss.global/foss.global
• changelog.md for @foss.global/foss.global

readme.md for @foss.global/foss.global

Official codebase for the foss.global website, built with TypeScript and the @api.global ecosystem.

Prerequisites

• Node.js (>=18)
• pnpm
• (Optional) GITEA_TOKEN environment variable or .nogit/GITEA_TOKEN file for fetching commit data

Installation

pnpm install

Build

Compile TypeScript and bundle the website:

pnpm build

Watch

Rebuild on file changes:

pnpm watch

Start

Start the CLI web server:

pnpm start

Start using the TypeScript entrypoint:

pnpm run startTs

Usage Example

After starting the server, open your browser at http://localhost:3000 to view the site and API.

Testing

Currently no automated tests are defined. The pnpm test command runs the build process.

Project Structure

./
├── ts/             # CLI source files
├── ts_web/         # Frontend source files
├── html/           # Static HTML templates
├── assets/         # Static assets (images, styles, etc.)
├── dist_ts/        # Compiled CLI output
├── dist_serve/     # Bundled website for serving
├── cli.js          # Node.js CLI entrypoint
├── cli.ts.js       # TypeScript CLI entrypoint
└── readme.md       # Project README

Module/Plugin Import Guidelines

CLI code imports modules via a central plugin file:

import * as plugins from './ffb.plugins.js';

Web code generally imports directly from packages or uses ts_web/plugins.ts when applicable.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -m "Add awesome feature")
4. Push to your fork (git push origin feature/YourFeature)
5. Open a pull request against the main branch

Please follow the existing code style and run pnpm build before submitting.

License

This project is UNLICENSED. See package.json for details.

Contact / Support

• Repository: https://code.foss.global/losslessone_websites/foss.global
• Issues: https://code.foss.global/losslessone_websites/foss.global/issues

changelog.md for @foss.global/foss.global

2025-09-16 - 1.6.3 - fix(dependencies)

Bump dependency and devDependency versions

• Upgrade @api.global/typedserver ^3.0.74 -> ^3.0.79
• Upgrade @design.estate/dees-catalog ^1.8.0 -> ^1.11.3
• Upgrade @design.estate/dees-domtools ^2.3.2 -> ^2.3.3
• Upgrade @design.estate/dees-element ^2.0.42 -> ^2.1.2
• Upgrade @foss.global/codefeed ^1.7.1 -> ^1.7.2
• Upgrade @push.rocks/qenv ^6.1.0 -> ^6.1.3
• Upgrade @push.rocks/smartlog ^3.0.7 -> ^3.1.9
• Upgrade @push.rocks/smartpath ^5.0.5 -> ^6.0.0
• Upgrade @push.rocks/smartstate ^2.0.0 -> ^2.0.27
• Upgrade devDependencies: @git.zone/tsbuild ^2.3.2 -> ^2.6.8, @git.zone/tsbundle ^2.2.5 -> ^2.5.1, @git.zone/tswatch ^2.1.0 -> ^2.2.1

2025-04-27 - 1.6.2 - fix(readme)

Update README to provide a concise project overview and add a documentation plan

• Replaced extended TypeScript utility documentation with a focused project description
• Updated prerequisites, installation, build, and usage instructions
• Added a new README plan outlining objectives and next steps for future documentation improvements

2025-04-26 - 1.6.1 - fix(dependencies)

Upgrade various dependencies and refine service configuration

• Updated @api.global/typedserver from ^3.0.51 to ^3.0.74
• Upgraded @design.estate/dees-catalog to ^1.8.0, dees-domtools to ^2.3.2, and dees-element to ^2.0.42
• Bumped @foss.global/codefeed to ^1.7.1
• Enhanced CodeFeed instantiation with caching, npm check, and taggedOnly options in ts/index.ts
• Replaced resolveExec with directives.resolveExec in the feedinfo element for consistency
• Added pnpm-workspace.yaml for only built dependencies configuration
• Updated packageManager field in package.json

2024-12-26 - 1.6.0 - feat(ui)

Enhancements to dotglobal-topbar and npm link correction

• Added slogan to the topbar component for better branding.
• Corrected the URL format for viewing packages on npm.

2024-12-17 - 1.5.0 - feat(web)

Introduce and style new dotglobal-navigation component

• Added a new navigation component 'dotglobal-navigation' to the web package.
• Updated styles for various elements to improve UI consistency and readability.
• Enhanced the dotglobal-feedinfo component with better layout and design adjustments.

2024-12-16 - 1.4.0 - feat(UI)

Enhance UI with top bar and updated styles

• Added a new 'dotglobal-topbar' component to the UI.
• Updated layout and styles for 'dotglobal-baselayout' and 'dotglobal-basicinfo' components.
• Improved feed information display with search and filters in 'dotglobal-feedinfo'.

2024-12-14 - 1.3.1 - fix(dotglobal-basicinfo)

Refactor 'dotglobal-basicinfo' component styles.

• Removed unnecessary style properties from the section and label elements.
• Reorganized and cleaned up CSS to improve readability and maintainability.

2024-12-14 - 1.3.0 - feat(ui)

UI enhancements and dependency updates.

• Updated UI components to include responsive grid for tablets.
• Integrated icons into release feed headers for visual enhancement.
• Conditionally display npm links based on publish status.
• Updated dependency @foss.global/codefeed to version 1.6.3.

2024-12-14 - 1.2.0 - feat(web)

Implemented periodic fetching of commit data and updated UI styles

• Changed commit fetching to a periodic task with improved error handling and retry logic.
• Updated styling for dotglobal-basicinfo and dotglobal-feedinfo components to enhance UI clarity.
• Added missing imports and improved code organization.

2024-12-14 - 1.1.0 - feat(core)

Enhance web elements and server functionality

• Integrate code feed fetching to the website server
• Add commit history display in the web interface
• Modify the grid layout for the base layout web component
• Update style properties for basic info and feed info components

2024-12-12 - 1.0.0 - Initial Release

First official release of the project.

• Established the initial codebase and project structure.