Organisation-level defaults for the F2i GitHub organisation.
GitHub treats a repository named .github specially. Files placed here apply across the organisation instead of to a single project. This repository currently holds one thing: the profile page that GitHub shows at the top of github.com/f2i-com.
| Path | Purpose |
|---|---|
profile/README.md |
The organisation profile. This is the page visitors see when they open the F2i organisation. It introduces the ecosystem, links each project and embeds screenshots pulled from the project repositories. |
README.md |
This file. It describes the repository itself, not the projects. |
The profile page is plain GitHub-flavoured Markdown with a little inline HTML for the layout. Some rules keep it working:
- Links and images must be absolute. The page is rendered on the organisation landing page, not inside a project checkout, so relative paths such as
docs/README.mdresolve to nothing. Point athttps://github.com/f2i-com/<repo>/blob/main/...for documents andhttps://raw.githubusercontent.com/f2i-com/<repo>/main/...for images. - Screenshots live with their projects. The page embeds images that are committed in
formlogic.com,softn.com,zipp.org,oaiy.comandaokie.com. Refresh a screenshot in its own repository and the profile picks it up without a change here. Each of those repositories documents how its screenshots were captured. - Keep project facts in sync with the project. Taglines, licences and status badges on the profile mirror each repository's own README. When one of those changes, update the profile row to match.
- Only public repositories can be linked or embedded. A private repository's raw image URLs return 404 for visitors.
Changes to profile/README.md appear on the organisation page as soon as they land on main.
Other files GitHub recognises in this repository, none of which exist yet:
CONTRIBUTING.md,CODE_OF_CONDUCT.md,SECURITY.mdandSUPPORT.mdact as the default community health files for any F2i repository that does not carry its own.ISSUE_TEMPLATE/andPULL_REQUEST_TEMPLATE.mdsupply default templates.workflow-templates/publishes starter GitHub Actions workflows to the organisation.FUNDING.ymlsets a default sponsor button.
A file in a project repository always takes precedence over the same file here. FormLogic, ZIPP and Aokie keep their own SECURITY.md; an organisation-wide default placed here would cover the projects that do not.
The profile page is the place to read about the ecosystem. The short version:
| Project | Repository |
|---|---|
| ZIPP, the execution engine | f2i-com/zipp.org |
| SoftN, the editable app language and runtime | f2i-com/softn.com |
| FormLogic, the business platform | f2i-com/formlogic.com |
| OAIY, the local AI workspace | f2i-com/oaiy.com |
| Aokie, the local AI receptionist | f2i-com/aokie.com |
| XDB, the local-first database | f2i-com/xdb.org |
Website: f2i.com