⚡ fastforge - Build apps faster with one toolkit

🖥️ Windows Download

1. Open the FastForge Releases page.
2. Find the latest release.
3. Download the Windows file from the Assets section.
4. Save the file to your computer.
5. Open the file to start the app or install the tool.

If the release includes a setup file, run it and follow the prompts. If it includes a zip file, extract it first, then open the app inside the folder.

📦 What FastForge Does

FastForge helps you create a full-stack web app with less setup work. It gives you:

• A FastAPI backend
• A React frontend, when you want one
• Database support for PostgreSQL, MySQL, SQLite, and MongoDB
• CLI tools for common project tasks
• Model stubs and code generation
• Admin access for early app testing

It is useful if you want to start with a simple project and add parts as you go.

🚀 Getting Started

1. Visit the FastForge Releases page.
2. Download the Windows build for your computer.
3. Open the file you downloaded.
4. If Windows asks for permission, choose Yes.
5. Follow the on-screen steps.
6. Open FastForge from the Start menu or from the folder where you saved it.

If the app starts in a terminal window, leave that window open while you use it.

🧭 First Run

When FastForge starts for the first time, it may create a local folder for your project files. This is normal.

You can then use it to:

• Create a new app project
• Pick a database
• Add a React frontend
• Generate model files
• Build basic API routes
• Prepare frontend client code

If you use the sample admin account, these are the default details:

• Email: [email protected]
• Password: admin123

💾 Recommended System Setup

FastForge works best on a Windows PC with:

• Windows 10 or Windows 11
• At least 8 GB of RAM
• 2 GB of free disk space
• A stable internet connection for setup and downloads
• Enough space for your project files and database data

For larger projects, more memory and disk space help keep things smooth.

🛠️ How to Use FastForge

1. Create a project

Start with a new project name. For example, you can make a project called my-app.

2. Choose your database

Pick the database that fits your app:

• PostgreSQL for larger apps
• MySQL for common web hosting setups
• SQLite for simple local projects
• MongoDB for flexible document data

3. Add the frontend

You can build only the backend first, or include React from the start if you want a web interface.

4. Add models

Models describe the data in your app. For example, a product model may include a name, price, and stock count.

5. Generate code

FastForge can create starter files from your model so you do not have to build everything by hand.

6. Start the app

After setup, start the backend and open the local web address in your browser.

🧩 Example Project Flow

A simple project often follows this flow:

1. Download FastForge from the Releases page
2. Open the app
3. Create a new project
4. Pick SQLite for a quick start
5. Add a product model
6. Generate the code
7. Start the backend
8. Open the local admin page in your browser

This gives you a working base for testing and learning.

🔧 Common Tasks

Create a new app

Use FastForge to start a fresh project with the parts you need.

Add a database

Choose the database during setup or change it later if your project grows.

Add a React front end

You can include React at the start or add it later when you need a user interface.

Create data models

Use models to define the things your app stores, such as users, orders, or products.

Generate starter files

FastForge can build code from your model so you can move faster.

Run the app locally

Open the backend in your browser and test the app on your own computer before sharing it with others.

📁 Typical Project Layout

A FastForge project may include folders like these:

• backend for server code
• frontend for React files
• models for data definitions
• routes for app paths
• schemas for data shapes
• static for files like images and icons
• templates for pages and view files

This layout helps keep the project organized.

🔍 If the App Will Not Open

If FastForge does not start, try these steps:

1. Close the app.
2. Open it again from the same file or folder.
3. Make sure Windows did not block the file.
4. Check that the download finished fully.
5. Move the file to a simple folder like Downloads or Desktop.
6. Try opening the program again.

If you use a zip file, make sure you extract it before opening the app.

🌐 Local Browser Address

After startup, FastForge may open a local page in your browser such as:

• http://localhost:8000
• http://localhost:8000/api/v1/docs

The first page is for the app. The docs page shows the API in the browser.

📚 What You Can Build

FastForge fits many small and mid-size apps, including:

• Admin dashboards
• Inventory tools
• Internal team apps
• Simple CRUD apps
• API services
• Data entry tools
• Prototype web apps

It gives you a clear place to start before you add custom features.

🧪 Example Admin Access

Some starter projects include a built-in admin account for testing.

• Email: [email protected]
• Password: admin123

Use it to check that the app works after setup.

🔗 Download FastForge

Visit the FastForge Releases page to download and run the Windows file from the latest release.

📝 Basic Terms

• Backend: the part of the app that handles data and logic
• Frontend: the part you see in the browser
• Model: a file that defines app data
• Database: where app data is stored
• CLI: a text-based tool for running commands

🧷 File Tips for Windows

• Keep the download in one folder
• Do not rename files unless needed
• Use a folder path you can find again
• If you extract a zip file, keep the folder together
• Open the app from the main file, not a random file inside the project

🧭 Next Steps After Setup

After FastForge is running, you can:

1. Create your first project
2. Add your first model
3. Generate code
4. Start the backend
5. Open the local docs page
6. Build more features over time