@foss.global/foss.global
Documentation 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:
Fork the repository
Create a feature branch (
git checkout -b feature/YourFeature)
Commit your changes (
git commit -m "Add awesome feature")
Push to your fork (
git push origin feature/YourFeature)
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.