inicontent 1.0.0

package/.github/pull_request.yml

@@ -0,0 +1,18 @@
+name: Code quality
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Biome
+        uses: biomejs/setup-biome@v2
+        with:
+          version: latest
+      - name: Run Biome
+        run: biome ci .

package/CONTRIBUTING.md

@@ -0,0 +1,67 @@
+# Contributing to Inicontent CMS
+
+Thanks for taking the time to contribute.
+
+## Getting Started
+
+1. Fork [inicontent/inicontent](https://github.com/inicontent/inicontent), then clone your fork:
+   ```bash
+   cd inicontent
+   ```
+2. Install dependencies (this project uses [pnpm](https://pnpm.io/)):
+   ```bash
+   pnpm install
+   ```
+3. Start the dev server:
+   ```bash
+   pnpm run dev
+   ```
+   The app runs at [http://localhost:3434](http://localhost:3434).
+
+## Project Structure
+
+- `app/` - Nuxt application: pages, components, composables, layouts, middleware, plugins, locales.
+- `modules/` - custom Nuxt modules (e.g. `naiveui.ts`).
+- `public/` - static assets.
+- `index.d.ts` - shared type declarations.
+
+## Branching and Commits
+
+- Branch off `main` using a short descriptive name, e.g. `fix/pdf-export-crash` or `feat/table-filters`.
+- Keep commits focused; one logical change per commit.
+- Write commit messages in imperative mood ("fix", "add", "refactor"), not past tense.
+
+## Code Style
+
+Linting and formatting are enforced with [Biome](https://biomejs.dev/):
+
+```bash
+pnpm lint    # check for issues
+pnpm format  # check and auto-fix
+```
+
+Run `pnpm lint` before opening a PR; CI runs `biome ci .` on every push and pull request and will fail on violations.
+
+Style conventions already encoded in `biome.json`:
+- Tabs for indentation.
+- Double quotes in JavaScript/TypeScript.
+- Imports auto-organized on save/format.
+
+## Pull Requests
+
+1. Ensure `pnpm lint` passes locally.
+2. Open the PR against `inicontent/inicontent`'s `main` branch.
+3. Describe **what** changed and **why** in the PR description; link any related issue.
+4. Keep PRs scoped to a single feature or fix, when possible, to make review easier.
+5. Be responsive to review feedback; a maintainer will merge once approved and CI is green.
+
+## Reporting Bugs
+
+Open an issue against [inicontent/inicontent](https://github.com/inicontent/inicontent/issues) with:
+- Steps to reproduce.
+- Expected vs. actual behavior.
+- Environment details (browser, Node version, OS).
+
+## Questions
+
+If something is unclear, open an issue or start a discussion before investing significant time in an implementation, especially for larger changes.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Inicontent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# Inicontent CMS
+
+## Introduction
+
+Inicontent CMS is a content management system built using [Nuxt](https://github.com/nuxt/nuxt) as its framework. It leverages modern tools such as:  
+- [Naive UI](https://github.com/tusen-ai/naive-ui) for a sleek component library.  
+- [Tabler Icons](https://github.com/tabler/tabler-icons) for intuitive and attractive icons.  
+- [Tiptap](https://github.com/ueberdosis/tiptap) for a powerful Rich Text Editor.
+
+## Features
+
+- **Multi-database admin** - manage one or many databases from a single `/admin` interface.
+- **Rich text editing** via [Tiptap](https://github.com/ueberdosis/tiptap).
+- **Sleek UI** built with [Naive UI](https://github.com/tusen-ai/naive-ui) and [Tabler Icons](https://github.com/tabler/tabler-icons).
+- **PWA-ready** out of the box.
+- **Drop-in as a Nuxt Layer**, or clone and customize directly.
+
+## Ecosystem
+
+- **[`inicontent/starter`](https://github.com/inicontent/starter)** — the minimal layer app to
+  build on. It ships `CONTEXT.md`, the AI-agent build context: authentication, the REST API,
+  the query language, table schemas & flows, and custom-route registration.
+- **`inicontent/api (private)`** — the server behind
+  `https://api.inicontent.com/`: REST CRUD per table, authentication, assets, and the built-in
+  AI-assistant endpoints (`{db}/ai`, `{db}/ai/tables`, …).
+
+## REST API & authentication (short version)
+
+Every database gets a public REST API at `https://api.inicontent.com/{databaseSlug}`:
+
+- `PUT {db}/auth/signin` with `{ "username": ..., "password": ... }` → returns a `sessionID`;
+  pass it on every request as the `{db}_sid` query param.
+- Table data: `GET/POST/PUT/DELETE {db}/{table}` — list pagination/projection live in the
+  Inison-stringified `options` query param and filters in `where`.
+- Structure: `GET/POST/PUT/DELETE inicontent/databases/{db}[/{table}]` for metadata, schemas,
+  flows (`onRequest`/`onResponse`), and table CRUD.
+- AI assistant: `POST {db}/ai` (router), then `POST/PUT {db}/ai/tables`, `{db}/ai/data`,
+  `{db}/ai/pages` … to design schemas, roles and demo data.
+
+See the `CONTEXT.md` shipped with `inicontent/starter` for the full reference (query language,
+schema field types, flows, routing).
+
+## Usage
+
+There are two ways to use this project:
+
+### 1. Recommended Method: Add as a Nuxt Layer
+
+The easiest way to integrate Inicontent CMS is to use it as a Nuxt Layer.  
+
+**Steps:**
+1. Add the repository as a layer in your `nuxt.config` file.
+2. Remove your existing `app.vue` file to avoid conflicts.  
+3. To override specific admin routes, create corresponding files in the `pages` directory. These will automatically override the default routes provided by the CMS.
+
+**Database Configuration:**  
+- By default, the CMS is a multi-database manager.  
+  - When no `database` is set in `.env`, the admin interface (`/admin`) will display all available databases. Users can then navigate to a specific database's admin panel at `/admin/<dbName>`.  
+  - If a `database` is specified in `.env`, the `/admin` route will directly display the tables for the specified database, removing the need to include the database name in the path.  
+
+**Example Configuration:**
+
+```javascript
+// nuxt.config.ts
+export default defineNuxtConfig({
+  extends: [["github:inicontent/inicontent", { install: true }]]
+});
+```
+
+```sh
+# .env
+database=DATABASE_SLUG
+```
+
+**Database configuration:**
+- The CMS is a multi-database manager by default.
+- When no `database` is set in `.env`, `/admin` lists all available databases; users navigate to a specific database's admin panel at `/admin/<dbName>`.
+- When `database` is set, `/admin` shows that database's tables directly, without the name in the path.
+
+This method keeps your project clean and makes updates to the CMS easy.
+
+### 2. Advanced Method: Clone and Edit the Repository
+
+If you need extensive customization, clone the repository and modify it directly.
+```bash
+git clone https://github.com/inicontent/inicontent.git
+cd inicontent
+pnpm install
+```
+
+## Environment Variables
+
+| Variable   | Required | Default                       | Description                                    |
+|------------|----------|--------------------------------|------------------------------------------------|
+| `database` | No       | `inicontent`                  | Database slug the admin panel targets directly. |
+| `apiBase`  | No       | `https://api.inicontent.com/` | Base URL for the Inicontent API.                |
+| `idOne`    | No       | (built-in default)            | Public identifier used by the API client.       |
+
+Copy these into a local `.env` file as needed; none are required to start the dev server.
+
+## Setup
+
+Install the dependencies to get started (any package manager works — npm, pnpm, yarn, or bun):  
+
+```bash
+npm install
+```
+
+## Development
+
+Start the development server at [http://localhost:3434](http://localhost:3434):
+
+```bash
+npm run dev
+```
+
+## Production
+
+Build the application for production:
+
+```bash
+npm run build
+```
+
+Preview the production build locally:
+
+```bash
+npm run preview
+```
+
+## Linting
+
+This project uses [Biome](https://biomejs.dev/) for linting and formatting:
+
+```bash
+pnpm lint    # check
+pnpm format  # check and write
+```
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, branch/commit conventions, and the PR process.

package/app/app.vue

@@ -0,0 +1,106 @@
+<template>
+	<NuxtPwaManifest />
+	<NuxtLayout>
+		<NuxtPage />
+	</NuxtLayout>
+</template>
+
+<script lang="ts" setup>
+import { useOsTheme } from "naive-ui";
+import { debounce, loadCoreTranslations } from "./composables";
+import { saveDatabaseConfigLocally } from "./composables/useLocalDatabaseConfig";
+
+const database = useState<Database>("database");
+const Language = useScopedCookie<LanguagesType>(
+	"language",
+	database.value?.slug,
+);
+
+// Load core translations with the initial language
+loadCoreTranslations(Language.value);
+
+// Watch for language changes and load translations dynamically
+watch(Language, async (newLang, oldLang) => {
+	if (newLang) await loadCoreTranslations(newLang, oldLang);
+});
+
+const Theme = useCookie<"light" | "dark">("theme", { sameSite: true });
+const sessionID = useScopedCookie<string>("sid", database.value?.slug);
+const osThemeRef = useOsTheme();
+const isManual = ref(false);
+if (!Theme.value) {
+	Theme.value = osThemeRef.value ?? "light";
+} else {
+	isManual.value = true;
+}
+
+watch(Theme, () => {
+	setThemeConfig();
+	if (Theme.value !== osThemeRef.value) {
+		isManual.value = true;
+	}
+});
+
+watch(osThemeRef, (newOsTheme) => {
+	if (!isManual.value && newOsTheme) {
+		Theme.value = newOsTheme;
+	}
+});
+
+watch(
+	() => database.value?.slug,
+	(slug) => {
+		syncCookiesFromDatabase(slug);
+	},
+	{ immediate: true },
+);
+
+watch(
+	[Language, Theme, sessionID, () => database.value?.slug],
+	() => {
+		syncCookiesToDatabase(database.value?.slug);
+	},
+	{ immediate: true },
+);
+
+// Persist the database config locally so the app stays reachable offline from
+// local storage even when the service worker cache is missing. The middleware
+// saves the initial fetch; this debounced deep watcher also catches config
+// updates made later (e.g. schema changes from the Settings page).
+const persistDatabaseConfigDebounced = debounce(() => {
+	const db = database.value;
+	if (db?.slug) saveDatabaseConfigLocally(db.slug, db);
+}, 2000);
+watch(
+	() => database.value,
+	() => {
+		persistDatabaseConfigDebounced();
+	},
+	{ deep: true },
+);
+
+// Initialize the offline queue tracker on boot so pending counts start
+// loading even before the Header (which hosts the SyncStatus badge) mounts.
+// Deferred to an idle callback so opening IndexedDB can never compete with
+// the first page's route-middleware fetch or initial render.
+onMounted(() => {
+	const runInit = () => useOfflineSync().initSync();
+	if ("requestIdleCallback" in window) {
+		// @ts-expect-error requestIdleCallback types not present
+		window.requestIdleCallback(runInit, { timeout: 3000 });
+	} else {
+		setTimeout(runInit, 500);
+	}
+});
+
+useHead({
+	bodyAttrs: {
+		class: computed(() =>
+			[
+				Language.value === "ar" ? "rtl" : "ltr",
+				Theme.value === "dark" ? "dark" : "light",
+			].join(" "),
+		),
+	},
+});
+</script>