Fix spelling of "AkoFlow" to "AkôFlow" across multiple files and update related messages for consistency

Author: ovvesley

cloud/README.md

@@ -1,3 +1,3 @@
 # Cloud
 
-Pasta reservada para a futura versão cloud do AkoFlow.
+Pasta reservada para a futura versão cloud do AkôFlow.

desktop/README.md

@@ -1,32 +1,32 @@
-# AkoFlow Desktop
+# AkôFlow Desktop
 
-Interface local do AkoFlow em Electron.
+Local interface for AkôFlow built with Electron.
 
-## O que ela faz
+## What it does
 
-- Verifica se o Docker está instalado.
-- Verifica se o daemon do Docker está ativo.
-- Orienta a instalação ou abertura do Docker Desktop quando necessário.
-- Serve como porta de entrada para o fluxo local que vai usar a imagem de release.
+- Checks if Docker is installed.
+- Checks if the Docker daemon is running.
+- Guides the user to install or open Docker Desktop when needed.
+- Serves as an entry point for the local flow that will use the release image.
 
-## Estrutura
+## Structure
 
-- `electron/` - processo principal, preload e integração com o sistema.
-- `renderer/app.js` - bootstrap da interface.
-- `renderer/components/` - blocos reutilizáveis da tela.
-- `renderer/services/` - acesso ao estado do Docker e ações externas.
-- `renderer/styles.css` - tema visual da aplicação.
-- `renderer/styles/` - tokens, layout, hero, status e responsividade.
+- `electron/` - main process, preload, and system integration.
+- `renderer/app.js` - interface bootstrap.
+- `renderer/components/` - reusable screen blocks.
+- `renderer/services/` - access to Docker state and external actions.
+- `renderer/styles.css` - application's visual theme.
+- `renderer/styles/` - tokens, layout, hero, status, and responsiveness.
 
-## Fluxo esperado
+## Expected flow
 
-1. Instalar as dependências com `npm install`.
-2. Abrir a aplicação com `npm start`.
-3. Se o Docker não existir, a tela mostra o link de instalação.
-4. Se o daemon estiver desligado, a tela orienta a abrir o Docker Desktop.
+1. Install dependencies with `npm install`.
+2. Open the application with `npm start`.
+3. If Docker is not installed, the screen shows the installation link.
+4. If the daemon is off, the screen guides the user to open Docker Desktop.
 
 ## Welcome flow
 
-- Tela inicial em etapas com animação e progresso.
-- Detecção automática do sistema para sugerir o download correto.
-- Caminho guiado: welcome, Docker, daemon, release image.
+- Step-by-step initial screen with animation and progress.
+- Automatic system detection to suggest the correct download.
+- Guided path: welcome, Docker, daemon, release image.

desktop/electron/main.js

@@ -10,11 +10,11 @@ const shouldOpenDevTools = process.env.AKOFLOW_OPEN_DEVTOOLS === '1';
 
 function logMain(message, details) {
   if (details !== undefined) {
-    console.log(`[AkoFlow] ${message}`, details);
+    console.log(`[AkôFlow] ${message}`, details);
     return;
   }
 
-  console.log(`[AkoFlow] ${message}`);
+  console.log(`[AkôFlow] ${message}`);
 }
 
 async function checkDockerStatus() {
@@ -28,7 +28,7 @@ async function checkDockerStatus() {
     return {
       status: 'missing',
       title: 'Docker not found',
-      message: 'Install Docker Desktop to continue using AkoFlow locally.',
+      message: 'Install Docker Desktop to continue using AkôFlow locally.',
       error: error?.message || 'Docker CLI is unavailable.',
       actionLabel: 'Install Docker Desktop',
       actionUrl: 'https://www.docker.com/products/docker-desktop/',
@@ -101,7 +101,7 @@ function getSystemInfo() {
   const platformLabel = platformLabels[platform] ?? platform;
   const architectureLabel = architectureLabels[architecture] ?? architecture.toUpperCase();
 
-  logs.push(`[AkoFlow] Collecting system information: ${platformLabel} / ${architectureLabel}`);
+  logs.push(`[AkôFlow] Collecting system information: ${platformLabel} / ${architectureLabel}`);
   logMain('Collecting system information', `${platformLabel} / ${architectureLabel}`);
 
   return {
@@ -171,7 +171,7 @@ function createWindow() {
     minWidth: 1100,
     minHeight: 760,
     backgroundColor: '#07111f',
-    title: 'AkoFlow Desktop',
+    title: 'AkôFlow Desktop',
     icon: path.join(__dirname, '..', 'assets', iconFile),
     webPreferences: {
       preload: path.join(__dirname, 'preload.js'),
@@ -209,10 +209,9 @@ function createWindow() {
 }
 
 /* ─────────────────────────────────────────────────────────────
-   AkoFlow container management
+   AkôFlow container management
 ───────────────────────────────────────────────────────────── */
 const AKOFLOW_CONTAINER = 'akoflow-local';
-const AKOFLOW_VOLUME    = 'akoflow-local-data';
 const AKOFLOW_IMAGE     = 'akoflow/akoflow';
 const AKOFLOW_PORT      = 7777;
 
@@ -270,21 +269,35 @@ ipcMain.handle('akoflow:pull-image', async (event) => {
 
 ipcMain.handle('akoflow:start-container', async () => {
   logMain('Starting container', AKOFLOW_CONTAINER);
-  // Remove any leftover container (stopped / exited)
+
+  // Check if a container already exists (may be stopped / exited)
   try {
-    await execFileAsync('docker', ['rm', '-f', AKOFLOW_CONTAINER], { timeout: 8000 });
-  } catch { /* nothing to remove */ }
+    const { stdout } = await execFileAsync('docker', [
+      'inspect', AKOFLOW_CONTAINER, '--format', '{{.State.Status}}',
+    ], { timeout: 5000 });
+
+    const status = stdout.trim();
+    logMain('Existing container found', status);
+
+    if (status === 'running') {
+      logMain('Container already running');
+      return { ok: true };
+    }
+
+    // Stopped / exited — restart it (preserves filesystem & data)
+    await execFileAsync('docker', ['start', AKOFLOW_CONTAINER], { timeout: 15000 });
+    logMain('Container restarted');
+    return { ok: true };
+  } catch { /* container does not exist — create it fresh */ }
 
   await execFileAsync('docker', [
     'run', '-d',
-    '--rm',
     '--name', AKOFLOW_CONTAINER,
     '-p', `${AKOFLOW_PORT}:80`,
-    '-v', `${AKOFLOW_VOLUME}:/data`,
     AKOFLOW_IMAGE,
   ], { timeout: 15000 });
 
-  logMain('Container started');
+  logMain('Container created and started');
   return { ok: true };
 });
 
@@ -347,13 +360,13 @@ app.on('window-all-closed', () => {
   }
 });
 
-// Stop the AkoFlow container gracefully when the app quits
+// Stop the AkôFlow container gracefully when the app quits
 let isQuitting = false;
 app.on('will-quit', (event) => {
   if (isQuitting) return;
   event.preventDefault();
   isQuitting = true;
-  logMain('App quitting — stopping AkoFlow container');
+  logMain('App quitting — stopping AkôFlow container');
   Promise.race([
     stopAkoflowContainer(),
     new Promise((resolve) => setTimeout(resolve, 6000)),

desktop/electron/preload.js

@@ -40,7 +40,7 @@ contextBridge.exposeInMainWorld('akoflow', {
     return ipcRenderer.invoke('docker:open-action', actionUrl);
   },
 
-  /* ── AkoFlow container ── */
+  /* ── AkôFlow container ── */
   checkAkoflowRunning: () => ipcRenderer.invoke('akoflow:check-running'),
   pullImage:           () => ipcRenderer.invoke('akoflow:pull-image'),
   startContainer:      () => ipcRenderer.invoke('akoflow:start-container'),

desktop/renderer/react/App.jsx

@@ -20,13 +20,13 @@ export function App() {
   }, []);
 
   if (phase === 'init') {
-    return <CheckingScreen message="Checking environment…" />;
+    return <InitSpinner />;
   }
 
   if (phase === 'already-running') {
     return (
       <CheckingScreen
-        message="AkoFlow is already running. Connecting…"
+        message="AkôFlow is already running. Connecting…"
         onReady={() => setPhase('app')}
       />
     );
@@ -58,6 +58,22 @@ export function App() {
   return null;
 }
 
+function InitSpinner() {
+  return (
+    <main className="single-screen">
+      <div className="single-screen__ambient single-screen__ambient--one" />
+      <section className="single-screen__card">
+        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkôFlow" />
+        <div className="single-screen__content">
+          <div className="loading-pulse">
+            <div className="loading-pulse__ring" />
+          </div>
+        </div>
+      </section>
+    </main>
+  );
+}
+
 function CheckingScreen({ message, onReady }) {
   useEffect(() => {
     if (!onReady) return undefined;
@@ -70,7 +86,7 @@ function CheckingScreen({ message, onReady }) {
       <div className="single-screen__ambient single-screen__ambient--one" />
       <div className="single-screen__ambient single-screen__ambient--two" />
       <section className="single-screen__card">
-        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkoFlow" />
+        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkôFlow" />
         <div className="single-screen__content single-screen__content--animated">
           <div className="loading-pulse">
             <div className="loading-pulse__ring" />

desktop/renderer/react/components/AppScreen.jsx

@@ -20,8 +20,8 @@ export function AppScreen({ onStop }) {
     <div className="app-screen">
       <header className="app-screen__header">
         <div className="app-screen__brand">
-          <img src={AKOFLOW_LOGO_URL} alt="AkoFlow" className="app-screen__logo" />
-          <span className="app-screen__name">AkoFlow</span>
+          <img src={AKOFLOW_LOGO_URL} alt="AkôFlow" className="app-screen__logo" />
+          <span className="app-screen__name">AkôFlow</span>
           <span className="app-screen__url">{APP_URL}</span>
         </div>
 
@@ -31,19 +31,18 @@ export function AppScreen({ onStop }) {
           onClick={handleStopClick}
           disabled={stopping}
         >
-          {stopping ? 'Stopping…' : '■ Stop AkoFlow'}
+          {stopping ? 'Stopping…' : '■ Stop AkôFlow'}
         </button>
       </header>
 
       {/* Confirm dialog */}
       {showConfirm && (
         <div className="app-screen__overlay">
           <div className="app-screen__dialog">
-            <img src={AKOFLOW_LOGO_URL} alt="AkoFlow" className="app-screen__dialog-logo" />
-            <h2 className="app-screen__dialog-title">Stop AkoFlow?</h2>
+            <img src={AKOFLOW_LOGO_URL} alt="AkôFlow" className="app-screen__dialog-logo" />
+            <h2 className="app-screen__dialog-title">Stop AkôFlow?</h2>
             <p className="app-screen__dialog-body">
-              The container will be stopped. Your environment data is preserved in the
-              <strong> akoflow-local-data</strong> volume — everything will be here when you come back.
+              The container will be stopped, but <strong>your environment is not removed</strong> — all data stays inside the container and will be here when you come back.
             </p>
             <div className="app-screen__dialog-actions">
               <button
@@ -68,7 +67,7 @@ export function AppScreen({ onStop }) {
       <iframe
         className="app-screen__iframe"
         src={APP_URL}
-        title="AkoFlow"
+        title="AkôFlow"
         allow="clipboard-read; clipboard-write"
       />
     </div>

desktop/renderer/react/components/DiagnosticsScreen.jsx

@@ -50,7 +50,7 @@ export function DiagnosticsScreen({ state, onRefresh, onLaunch }) {
   };
 
   const nextLabel = (() => {
-    if (isLastStep)      return 'Launch AkoFlow →';
+    if (isLastStep)      return 'Launch AkôFlow →';
     if (stepIndex === 1 && state.error) return 'Continue anyway →';
     return 'Next →';
   })();
@@ -61,7 +61,7 @@ export function DiagnosticsScreen({ state, onRefresh, onLaunch }) {
       <AmbientBlobs />
 
       <section className="single-screen__card">
-        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkoFlow" />
+        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkôFlow" />
 
         <StepIndicator steps={STEPS} current={stepIndex} />
 
@@ -179,7 +179,7 @@ function LogPanel({ logs, error }) {
 function StepWelcome() {
   return (
     <>
-      <div className="single-screen__label">Welcome to AkoFlow</div>
+      <div className="single-screen__label">Welcome to AkôFlow</div>
       <h1 className="single-screen__title">Local<br />Release.</h1>
       <p className="single-screen__copy">
         Preparing your environment. System checks will begin automatically.
@@ -269,7 +269,7 @@ function StepReady({ state, systemSummary, systemOk, dockerOk }) {
       <div className="single-screen__label">All set.</div>
       <h1 className="single-screen__title">Ready to<br />launch.</h1>
       <p className="single-screen__copy">
-        AkoFlow will be pulled and started via Docker.
+        AkôFlow will be pulled and started via Docker.
       </p>
       <CheckList checks={checks} />
     </>

desktop/renderer/react/components/LaunchingScreen.jsx

@@ -3,7 +3,7 @@ import { AKOFLOW_LOGO_URL } from '../brandAssets.jsx';
 
 const LAUNCH_STEPS = [
   { id: 'pull',   label: 'Pulling latest image',  detail: 'akoflow/akoflow' },
-  { id: 'start',  label: 'Starting container',     detail: `Port 7777 · Volume akoflow-local-data` },
+  { id: 'start',  label: 'Starting container',     detail: 'Port 7777 · akoflow-local' },
   { id: 'health', label: 'Waiting for service',    detail: 'http://localhost:7777' },
 ];
 
@@ -113,10 +113,10 @@ export function LaunchingScreen({ onLaunched, onBack }) {
       <div className="single-screen__ambient single-screen__ambient--three" />
 
       <section className="single-screen__card launching-card">
-        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkoFlow" />
+        <img className="single-screen__logo" src={AKOFLOW_LOGO_URL} alt="AkôFlow" />
 
         <div className="single-screen__content single-screen__content--animated">
-          <div className="single-screen__label">Launching AkoFlow</div>
+          <div className="single-screen__label">Launching AkôFlow</div>
           <h1 className="single-screen__title">{titleText}</h1>
         </div>
 

desktop/renderer/react/components/ReleaseStep.jsx

@@ -3,10 +3,10 @@ import { AKOFLOW_BANNER_URL } from '../brandAssets.jsx';
 export function ReleaseStep({ systemInfo }) {
   return (
     <div className="step-card step-card--release">
-      <img className="release-image" src={AKOFLOW_BANNER_URL} alt="AkoFlow release banner" />
+      <img className="release-image" src={AKOFLOW_BANNER_URL} alt="AkôFlow release banner" />
       <div className="step-card__headline">Latest release ready</div>
       <p className="step-card__text">
-        We will pull the latest AkoFlow release image and build it locally. The environment is ready to continue.
+        We will pull the latest AkôFlow release image and build it locally. The environment is ready to continue.
       </p>
       <div className="step-info">
         <span>Platform: {systemInfo?.platformLabel || 'Unknown'}</span>

desktop/renderer/react/components/WelcomeStep.jsx

@@ -4,7 +4,7 @@ export function WelcomeStep({ onStart }) {
   return (
     <div className="welcome-step">
       <div className="welcome-step__brand">
-        <img className="welcome-step__icon" src={AKOFLOW_LOGO_URL} alt="AkoFlow logo" />
+        <img className="welcome-step__icon" src={AKOFLOW_LOGO_URL} alt="AkôFlow logo" />
       </div>
       <h2 className="welcome-step__title">Local release.</h2>
       <div className="welcome-step__chips">